前言¶
做盡調、風控或競品分析時，常見做法是讓同事手工打開數據平臺查工商、股權和風險，再把結果貼回對話或文檔。Agent 能寫總結，卻缺一套可複用的「查企業」能力：既要覆蓋工商、股權、風險、招投標等維度，又要在對話裏按自然語言觸發，而不是每次重寫 HTTP 調用。
下面介紹的 Skill「企查查企業查詢」掛在 SkillHub 社區（座標 @user_db7424f5/udb7-qcc-company-query，版本 1.0.0），面向企業數據查詢、篩選與關係分析。實現上通過同花順快查網關（默認 https://bizveris.kuaicha365.com）拉數，運行前需配置 KUAICHA_API_KEY；Skill 頁標註 requires_api_key=true。名稱帶「企查查」，憑證與接口歸屬快查，接入前請按自己的合規要求覈對數據來源。
這是什麼¶
一句話定位：把快查企業數據能力封裝成 Agent Skill，用自然語言完成查詢與關係分析。
- 維護方：SkillHub 社區發佈者
user_db7424f5，來源標記爲community，分類爲professional。 - 解決的問題：在 Cursor、Claude Code 等支持 Skills 的環境裏，讓模型在對話中發起企業維度的查詢，而不必每次手寫網關請求。
- 與純 MCP 的差異：本 Skill 自帶
discover/call腳本走快查 Skill 匹配與網關；若你已在客戶端配置企查查官方 MCP（Streamable HTTP），那是另一條接入線，本文只寫本 Skill 包內的用法。
SkillHub 頁面當前顯示評分 100000、下載 6880 次（統計以頁面爲準）。
核心功能¶
依據 Skill 元數據與包內說明，已覈實的能力範圍如下。
- 企業數據查詢：工商、股權、風險、招投標等（簡介中的列舉維度）。
- 篩選：支持按條件找企業（示例中包含「杭州最近新成立的科技公司」類需求）。
- 關係分析：示例中包含企業間股權關係類問題（如「騰訊與京東間是否有股權關係」）。
- 自動喚起：
auto_invoke: true，滿足企業查詢意圖時 Agent 可主動加載本 Skill。 - 安全約束（
SKILL.md聲明）：不啓用子進程、eval、文件讀寫等權限，降低 Skill 側越權面。
包內通過 scripts/kuaicha_client.mjs 調用快查接口：先用自然語言做工具匹配（POST /api_route/skill/match），再按 tool_id 調網關（POST /api_route/gateway/{tool_id}），請求頭使用 open-authorization: Bearer <KUAICHA_API_KEY>。
安裝與啓用¶
1. 準備 SkillHub CLI¶
按 SkillHub 安裝說明 檢查或安裝 CLI：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝腳本（文檔中的推薦方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。常見路徑（摘自安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
安裝命令示例（社區命名空間 user_db7424f5）：
skillhub install udb7-qcc-company-query --namespace user_db7424f5 --dir ~/.cursor/skills
也可把下面提示詞發給 AI，讓其按官方安裝文檔拉取同一座標：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_db7424f5/udb7-qcc-company-query`。
安裝後按你所用客戶端說明重啓或刷新 Skills 列表。
3. 配置 KUAICHA_API_KEY¶
Skill 聲明的環境變量爲 KUAICHA_API_KEY。包內 kuaicha_env.mjs 的讀取順序爲：
- 進程環境變量
KUAICHA_API_KEY（優先） - Skill 目錄下的
config.txt，單行格式KUAICHA_API_KEY=你的密鑰 - 用戶目錄
~/.kuaicha/config，同樣KUAICHA_API_KEY=格式
可選：通過 KUAICHA_BASE_URL 覆蓋默認網關地址 https://bizveris.kuaicha365.com。
密鑰需在快查側申請 MCP Key（勿與標準 API 的 appKey/appSecret 混用）；具體創建路徑見 快查文檔中心。不要把完整 Key 提交到公開倉庫或對話截圖。
典型用法¶
對話示例（官方 examples）¶
SKILL.md 中給出的自然語言示例可直接用於驗證 Skill 是否被正確喚起：
- 查詢同花順的工商基本信息
- 查一下騰訊的股東結構和最終受益人
- 恒大有沒有經營異常或行政處罰
- 樂視網有沒有司法風險和失信記錄
- 華爲有多少專利和商標
- 最近關於阿里的新聞報道有哪些
- 杭州最近新成立的科技公司有哪些
- 騰訊與京東間是否有股權關係
Agent 加載 Skill 後，應走「先發現工具、再按 tool_id 調用」的流程；查詢失敗時需說明嘗試過的工具與錯誤，不要編造企業數據。
命令行調試（包內腳本）¶
需要在終端覈對網關與 Key 時，可進入 Skill 安裝目錄下的 scripts/，用 Node 調用 kuaicha_tool.mjs：
cd ~/.cursor/skills/@user_db7424f5/udb7-qcc-company-query/scripts
# 用中文能力描述做工具發現（可加 --limit）
node kuaicha_tool.mjs discover "企業基本信息查詢" --limit 3
# 使用返回的 tool_id 調用（參數示例爲 JSON 或 key=value）
node kuaicha_tool.mjs call <tool_id> --params '{"corp_name":"示例企業名稱"}'
discover 對應快查 Skill 匹配接口；call 將結構化參數 POST 到對應網關工具。Windows 下文檔建議使用 --params "key=value&key2=value2" 形式傳參。
適用場景與注意¶
適合誰
- 已在 Agent 工作流裏做企業背調、風險掃描、競對信息收集的開發者或分析師。
- 願意使用快查 MCP Key、並接受按次/按賬戶計費的團隊。
限制與坑
- 名稱與數據源：Skill 對外名稱是「企查查企業查詢」，實際請求快查網關；若業務合同要求企查查官方數據，應使用企查查開放平臺 MCP 等正式渠道，勿僅憑名稱假設供應商。
- 密鑰類型：必須使用快查 MCP Key；標準 API Token 不能替代（見快查憑證說明文檔）。
- 權限與額度：工具可見範圍、調用是否成功，取決於 Key 權限與賬戶額度；空結果不等於連接失敗，需覈對企業名稱、統一社會信用代碼等參數。
- Skill 正文較短：當前
1.0.0包內SKILL.md以元數據與示例爲主，詳細字段說明依賴discover返回的工具定義；複雜查詢宜先在 CLI 試跑再交給 Agent。 - 合規呈現：向最終用戶展示查詢結果時，應如實標註數據來源於快查企業數據引擎（與同花順快查類產品慣例一致），並遵守平臺使用條款。
結尾¶
「企查查企業查詢」把快查側的企業查詢、篩選與關係分析能力接到 SkillHub 生態：裝好 CLI、把包裝進 Agent skills 目錄、配置 KUAICHA_API_KEY 後，即可用對話或包內腳本完成從工具發現到數據拉取的全流程。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_db7424f5/udb7-qcc-company-query
- 安裝座標 API 頁：https://api.skillhub.cn/user_db7424f5/udb7-qcc-company-query
- 安裝文檔：https://skillhub.cn/install/skillhub.md
