搜索文档、文章、Skill 和 MCP
用 OpenAPI 搜索资源、读取安装信息和文档。
在程序中搜索资源、读取安装信息和文档。
读取文档 Markdown 无需授权；调用其他接口需传入 API Key。
GET/api/cli/search?q=pdf&limit=3
通过 X-API-Key 请求头传入密钥。
curl -H "X-API-Key: $FUNCODING_API_KEY" \ "https://funcoding.ai/api/cli/search?q=pdf&limit=3"
读取文档 Markdown 无需授权；调用其他接口需传入 API Key。
创建 API Key
登录后，前往个人中心的「API Key」页创建密钥。密钥以 fc_ 开头，仅在创建时完整显示一次。
在请求头中传入 API Key
通过 X-API-Key 请求头传入，或使用 Authorization: Bearer 后接 API Key。请勿将密钥写入网页或公开仓库。
请求示例
curl -H "X-API-Key: $FUNCODING_API_KEY" \ "https://funcoding.ai/api/cli/search?q=pdf&limit=3"
接口均使用 GET 请求。成功时返回 JSON，文档全文返回 Markdown。
GET/api/cli/search
按名称和描述匹配，名称完全相同的排在最前，同级按 star 排序。只返回站点上展示的条目。
| 参数 | 位置 | 说明 |
|---|---|---|
| q* | 查询 | 搜索词，最多 100 个字符 |
| limit | 查询 | 返回条数，1–30，默认 10 |
* 为必填
curl -H "X-API-Key: $FUNCODING_API_KEY" \ "https://funcoding.ai/api/cli/search?q=pdf&limit=3"
返回：两组卡片：skills 和 mcp。400 401 429
GET/api/cli/skills/{owner}/{repo}/{skill}
返回文件清单、下载地址前缀和 SKILL.md 全文。文件地址是 rawBase 加文件的相对路径，从 GitHub 下载。
| 参数 | 位置 | 说明 |
|---|---|---|
| owner* | 路径 | GitHub 用户或组织 |
| repo* | 路径 | 仓库名 |
| skill* | 路径 | Skill 名 |
* 为必填
curl -H "X-API-Key: $FUNCODING_API_KEY" \ "https://funcoding.ai/api/cli/skills/anthropics/skills/pdf"
返回：安装需要的全部信息，content 是 SKILL.md 全文。400 401 404 429 502
GET/api/cli/mcp/{owner}/{repo}
列出远程地址和本地启动命令（npx 或 uvx），以及需要提供的请求头和环境变量。同一仓库里有多个 Server 时，在路径最后加上子目录名。
| 参数 | 位置 | 说明 |
|---|---|---|
| owner* | 路径 | GitHub 用户或组织 |
| repo* | 路径 | 仓库名 |
* 为必填
curl -H "X-API-Key: $FUNCODING_API_KEY" \ "https://funcoding.ai/api/cli/mcp/microsoft/playwright-mcp"
返回：launches 为空时，说明没有登记可以直接使用的启动方式，去仓库查看。400 401 404 429
GET/api/cli/docs/search
在站内的智能体文档里按关键词搜索。
| 参数 | 位置 | 说明 |
|---|---|---|
| q* | 查询 | 搜索词，最多 100 个字符 |
| agent | 查询 | 只搜一个智能体，如 claude-code |
| limit | 查询 | 返回条数，1–30，默认 10 |
* 为必填
curl -H "X-API-Key: $FUNCODING_API_KEY" \ "https://funcoding.ai/api/cli/docs/search?q=hooks&agent=claude-code"
返回：文档列表，id 可以直接用来读取全文。400 401 429
GET/api/cli/docs/{agent}/{path}不需要授权
Markdown 原文，开头写明网址、核实或同步日期和官方来源，站内链接已改成完整网址。path 可以含多级目录；省略 path 时返回智能体的概览。
| 参数 | 位置 | 说明 |
|---|---|---|
| agent* | 路径 | 智能体，如 claude-code |
| path* | 路径 | 文档路径，如 build/skills |
| lang | 查询 | 传 en 读英文版，没有英文版时返回中文 |
* 为必填
curl "https://funcoding.ai/api/cli/docs/claude-code/build/skills"
返回：Markdown 文本。404 429
GET/api/cli/lists/{shareId}
用户公开分享的 Skill 和 MCP Server 清单，只包含仍在站点上展示的条目。shareId 是分享链接 /share/<shareId>/ 的最后一段。
| 参数 | 位置 | 说明 |
|---|---|---|
| shareId* | 路径 | 分享链接里的 10 位 id |
* 为必填
curl -H "X-API-Key: $FUNCODING_API_KEY" \
"https://funcoding.ai/api/cli/lists/{shareId}"返回：清单标题、分享者和两组卡片。401 404 429
GET/api/cli/news
不带 daily 时返回当前热榜；带 daily 时返回那一天的 AI 日报。数据来自 AIHOT，展示时请保留来源名和原文链接。
| 参数 | 位置 | 说明 |
|---|---|---|
| limit | 查询 | 返回条数，1–10，默认 10 |
| daily | 查询 | latest 表示最新一期，或写成 YYYY-MM-DD |
* 为必填
curl -H "X-API-Key: $FUNCODING_API_KEY" \ "https://funcoding.ai/api/cli/news?limit=5"
返回：热榜条目和 attribution；日报的格式见 /openapi.json。401 404 429
限额按账号计算，所有 API Key 和 funcoding-cli 登录共用。
响应头里的 X-RateLimit-Remaining 和 X-RateLimit-Daily-Remaining 是这一分钟和今天还剩的次数。超过时返回 429，Retry-After 是需要等待的秒数。
出错时返回对应的状态码和 { "error": "…" }