SpecFusion
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 22 GitHub stars
Code Fail
- process.env — Environment variable access in api/src/index.ts
- process.env — Environment variable access in api/src/middleware/auth.ts
- exec() — Shell command execution in api/src/routes/admin.ts
- process.env — Environment variable access in api/src/routes/admin.ts
Permissions Pass
- Permissions — No dangerous permissions requested
This tool is an MCP server that allows you to search through 56,700+ API documentation pages for 18 major Chinese tech platforms (such as WeChat, DingTalk, and Taobao) directly within AI coding assistants like Claude Code and Cursor. It is designed to let developers quickly find interface parameters and error codes without leaving their terminal.
Security Assessment
The overall risk is rated as High. While the tool is marketed as a zero-configuration "skill" that simply downloads a markdown file to your local system, the underlying GitHub repository contains a full backend API with significant security concerns.
The scan detected a critical failure due to shell command execution (`exec()`) inside an admin route (`api/src/routes/admin.ts`). If this API server is exposed or run locally, this functionality creates a severe risk of remote code execution. Additionally, the repository accesses environment variables in multiple files (including the main index, middleware, and admin routes), which could potentially expose local system configurations or secrets if the backend is compiled and run. No hardcoded secrets were detected, and the MCP client itself does not request dangerous system permissions.
Quality Assessment
The project is actively maintained, with its last code push occurring today. It is properly licensed under the standard MIT license, allowing for free use and modification. However, community trust is currently very low, with only 22 GitHub stars, indicating that the codebase has not been widely reviewed or battle-tested by a large developer community.
Verdict
Use with caution: While the markdown-only client setup appears harmless, the underlying repository contains dangerous shell execution capabilities in its backend code, so developers should thoroughly inspect the source code and avoid running the actual API server without extreme care.
在 Claude Code / Cursor / Gemini CLI 里直接搜 18 个中国开放平台 API 文档 | Search 18 Chinese platform API docs (WeChat, Feishu, DingTalk, Taobao, etc.) directly in your AI coding tool. 56,700+ docs, zero config.
SpecFusion
在 Claude Code 里直接搜企业微信、飞书、钉钉、淘宝开放平台、小红书、抖音电商开放平台、微信小程序、微信小店、拼多多开放平台、有赞开放平台、微信支付、支付宝开放平台、京东商家开放平台、SHEIN开放平台、得物开放平台、火山引擎、阿里云百炼的 API 文档。
不用切浏览器,不用翻文档站——输入问题,拿到接口参数,继续写代码。
> 企业微信怎么发应用消息?
搜索到 3 篇相关文档:
1. 发送应用消息 — POST /cgi-bin/message/send
2. 接收消息与事件 — 被动回复消息
3. 消息类型及数据格式 — text/image/voice/...
为什么用 SpecFusion
- 不离开终端 — 写代码时直接问,Claude 帮你查文档、给出接口参数和示例
- 中文搜索准确 — jieba 分词 + FTS5 全文索引,
发送应用消息、access_token、40001都能搜到 - 56,700+ 篇文档 — 企业微信 ~2,690 篇 + 飞书 ~4,070 篇 + 钉钉 ~2,020 篇 + 淘宝 ~6,740 篇 + 小红书 ~100 篇 + 抖音电商 ~1,280 篇 + 微信小程序 ~280 篇 + 微信小店 ~480 篇 + 拼多多 ~280 篇 + 有赞 ~1,240 篇 + 微信支付 ~540 篇 + 支付宝 ~600 篇 + 京东 ~6,100 篇 + SHEIN ~190 篇 + 得物 ~260 篇 + 火山引擎ECS ~136 篇 + 火山引擎 ~28,660 篇 + 阿里云百炼 ~1,110 篇,接口参数、错误码、事件订阅全覆盖
- 零配置 — 云端服务已部署好,安装 Skill 后即可使用,无需自建后端
安装
方式一:skills CLI(推荐)
自动检测已安装的 Agent,一键全局安装到 Claude Code、Codex、Gemini CLI 等:
npx skills add wxkingstar/SpecFusion -g -y
⚠️ 必须加
-g参数! 不加-g会安装到当前目录,只在该目录下生效。加-g安装到~/.claude/skills/,所有项目都能用。
仅安装到 Claude Code:
npx skills add wxkingstar/SpecFusion -g -a claude-code -y
也可以按平台名搜索安装:
npx skills find "feishu" # 搜索飞书相关技能
npx skills find "taobao" # 搜索淘宝相关技能
npx skills find "wecom" # 搜索企业微信相关技能
npx skills find "dingtalk" # 搜索钉钉相关技能
npx skills find "alipay" # 搜索支付宝相关技能
npx skills find "jd" # 搜索京东相关技能
# ... 支持所有已接入平台的英文名搜索
方式二:手动安装
Claude Code(macOS / Linux):
curl -fsSL --create-dirs -o ~/.claude/skills/specfusion/SKILL.md \
https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md
Claude Code(Windows PowerShell):
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\specfusion" | Out-Null
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md" `
-OutFile "$env:USERPROFILE\.claude\skills\specfusion\SKILL.md"
Cursor(macOS / Linux):
curl -fsSL --create-dirs -o ~/.cursor/rules/specfusion.mdc \
https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md
Cursor(Windows PowerShell):
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.cursor\rules" | Out-Null
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md" `
-OutFile "$env:USERPROFILE\.cursor\rules\specfusion.mdc"
安装完成。打开 Claude Code 或 Cursor,开始提问即可。
安装后找不到 Skill?
| 问题 | 原因 | 解决方案 |
|---|---|---|
| Claude Code 找不到 | 安装时没加 -g,只装到了当前目录 |
重新运行 npx skills add wxkingstar/SpecFusion -g -y |
| Cursor 找不到 | skills CLI 目前不会为 Cursor 创建规则文件 | 用上面的手动安装命令 |
| 验证是否安装成功 | — | Claude Code: ls ~/.claude/skills/specfusion/SKILL.mdCursor: ls ~/.cursor/rules/specfusion.mdc |
使用方式
方式一:直接提问(提到企业微信、飞书、钉钉、淘宝、小红书、抖音电商、微信小程序、微信小店、拼多多、有赞、微信支付、支付宝、京东、SHEIN、得物、火山引擎、百炼等关键词时自动触发)
> 飞书如何创建审批实例?
> 企业微信的 access_token 怎么获取?
> 钉钉怎么发工作通知?
> 淘宝商品发布接口怎么用?
> 抖音电商怎么查询订单列表?
> 微信小程序怎么获取手机号?
> 微信小店怎么获取订单列表?
> 拼多多怎么同步订单?
> 有赞怎么查询交易订单?
> wecom webhook 怎么发消息?
> 微信支付JSAPI下单接口怎么调?
> 支付宝当面付接口怎么用?
> SHEIN商品发布接口怎么调?
> 得物开放平台怎么查询订单?
> 火山引擎ECS怎么创建实例?
> 百炼千问API怎么调用?
方式二:使用 /specfusion 命令
> /specfusion 企业微信发送应用消息
> /specfusion feishu 获取用户列表
已接入平台
| 平台 | 文档数量 | 覆盖范围 |
|---|---|---|
| 企业微信 | ~2,680 | 服务端 API、客户端 API、应用开发 |
| 飞书 | ~4,070 | 服务端 API、事件订阅、小程序 |
| 钉钉 | ~2,020 | 企业内部应用、服务端 API、客户端 JSAPI |
| 淘宝开放平台 | ~6,740 | 商品、交易、物流、店铺、用户等 API |
| 小红书 | ~100 | 电商开放平台 API(订单、商品、售后、物流等) |
| 抖音电商开放平台 | ~1,280 | 商品、订单、物流、售后、精选联盟、即时零售等 API |
| 微信小程序 | ~280 | 服务端 API(登录、用户信息、小程序码、客服、数据分析、安全、物流等) |
| 微信小店 | ~480 | 商品管理、订单管理、售后管理、物流发货、资金结算、营销优惠券等 API |
| 拼多多开放平台 | ~280 | 订单、商品、物流、售后、营销、店铺、虚拟类目、多多进宝等 API |
| 有赞开放平台 | ~1,240 | 用户、会员、商品、交易、物流、营销、店铺、分销、财务、美业等 API |
| 微信支付 | ~540 | JSAPI/APP/H5/Native/小程序支付、退款、分账、合单支付、代金券、商家转账等 API |
| 支付宝开放平台 | ~600 | 当面付、APP支付、手机网站支付、电脑网站支付、资金、会员、营销、安全等 API |
| 京东商家开放平台 | ~6,100 | 商品、订单、物流、售后、促销、店铺、数据、发票、供应商等 API |
| SHEIN开放平台 | ~190 | 密钥授权、商品、订单、退货退款、采购单、库存、财务、物流、Webhook 等 API |
| 得物开放平台 | ~260 | 商品、订单、售后、出价、入仓、开票、文件、对账单等 API |
| 火山引擎云服务器 | ~136 | 实例、镜像、密钥对、安全组、地域、部署集、专有宿主机、云助手等 API |
| 火山引擎 | ~28,660 | 184 个云产品文档:计算、AI、网络、存储、数据库、容器、安全、CDN、视频云、大数据等 |
| 阿里云百炼 | ~1,110 | 千问大模型、DashScope SDK、OpenAI兼容接口、语音合成/识别、图像/视频生成、应用开发等 |
仅在当前项目安装
如果只想在某个项目中使用,可以安装到项目目录(不加 -g):
# 在项目根目录下运行
npx skills add wxkingstar/SpecFusion -y
或手动安装(将 ~ 换成 .):
Claude Code(macOS / Linux):
curl -fsSL --create-dirs -o .claude/skills/specfusion/SKILL.md \
https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md
Claude Code(Windows PowerShell):
New-Item -ItemType Directory -Force -Path ".claude\skills\specfusion" | Out-Null
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md" `
-OutFile ".claude\skills\specfusion\SKILL.md"
Cursor:
curl -fsSL --create-dirs -o .cursor/rules/specfusion.mdc \
https://raw.githubusercontent.com/wxkingstar/SpecFusion/main/specfusion/SKILL.md
自部署
默认使用公共云端服务,无需自部署。如果需要私有化部署或自定义数据源,可以自建。
Docker 部署
docker build -t specfusion .
docker run -d \
-p 3456:3456 \
-v $(pwd)/data:/app/data \
-e ADMIN_TOKEN=your-secret-token \
--name specfusion \
specfusion
启动后将 Skill 中的 API 地址替换为你的实例:
# macOS
sed -i '' 's|http://specfusion.inagora.org/api|http://your-host:3456/api|g' \
~/.claude/skills/specfusion/SKILL.md
# Linux
sed -i 's|http://specfusion.inagora.org/api|http://your-host:3456/api|g' \
~/.claude/skills/specfusion/SKILL.md
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
PORT |
3456 |
服务端口 |
DB_PATH |
./data/specfusion.db |
SQLite 数据库路径 |
ADMIN_TOKEN |
dev-token |
Admin API 认证令牌 |
文档同步
npm install
npm run sync -- --source feishu # 同步飞书文档
npm run sync -- --source wecom # 同步企业微信文档
npm run sync -- --source dingtalk # 同步钉钉文档(需要 playwright)
npm run sync -- --source taobao # 同步淘宝开放平台文档
npm run sync -- --source xiaohongshu # 同步小红书文档
npm run sync -- --source douyin # 同步抖音电商开放平台文档
npm run sync -- --source wechat-miniprogram # 同步微信小程序文档
npm run sync -- --source wechat-shop # 同步微信小店文档
npm run sync -- --source pinduoduo # 同步拼多多开放平台文档(需先导出 JSON)
npm run sync -- --source youzan # 同步有赞开放平台文档
npm run sync -- --source wechat-pay # 同步微信支付文档
npm run sync -- --source alipay # 同步支付宝开放平台文档
npm run sync -- --source jd # 同步京东商家开放平台文档
npm run sync -- --source shein # 同步SHEIN开放平台文档
npm run sync -- --source dewu # 同步得物开放平台文档(需要 playwright)
npm run sync -- --source volcengine-ecs # 同步火山引擎云服务器文档
npm run sync -- --source volcengine # 同步火山引擎文档中心
npm run sync -- --source bailian # 同步阿里云百炼文档
同步完成后数据库文件位于 data/specfusion.db。
本地开发
npm install
npm run dev # 启动开发服务器(热重载)
npm run build # 构建
API 参考
所有 API 返回 Markdown 纯文本(Content-Type: text/markdown),可直接阅读。
Base URL: http://localhost:3456/api(自部署)
| 端点 | 说明 |
|---|---|
GET /api/search?q=关键词&source=wecom&limit=5 |
搜索文档 |
GET /api/doc/{doc_id} |
获取文档全文 |
GET /api/doc/{doc_id}?summary=true |
获取文档摘要 |
GET /api/sources |
查看已接入文档源 |
GET /api/categories?source=wecom |
浏览文档分类 |
GET /api/recent?source=wecom&days=7 |
最近更新的文档 |
GET /api/health |
健康检查(返回 JSON) |
搜索参数
| 参数 | 必填 | 说明 |
|---|---|---|
q |
是 | 搜索关键词(接口名、API 路径、错误码、功能概念) |
source |
否 | 文档来源:wecom / feishu / dingtalk / taobao / xiaohongshu / douyin / wechat-miniprogram / wechat-shop / pinduoduo / youzan / wechat-pay / alipay / jd / shein / dewu / volcengine-ecs / volcengine / bailian |
mode |
否 | 开发模式(仅企业微信):internal / third_party / service_provider |
limit |
否 | 返回数量,默认 5,最大 20 |
技术栈
- API: Node.js + Fastify + better-sqlite3 + FTS5
- 中文分词: nodejieba
- Scraper: cheerio + playwright
- 构建: tsup + tsx
贡献
欢迎提交 Issue 和 Pull Request。
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/xxx) - 提交更改 (
git commit -m 'Add xxx') - 推送分支 (
git push origin feature/xxx) - 创建 Pull Request
License
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found