前言¶
在 DeepSeek Harness（DSH）裏做內容策略、競品分析或頁面優化時，Agent 往往只能憑訓練數據「猜」排名、搜索量和外鏈情況，結論不可靠。CallAI SEO MCP 插件（npm 包 @callaiapi/seo，倉庫 hanshengcc/callai-seo-mcp）通過 MCP 把 Google/Bing 實時 SERP、關鍵詞指標、競品差距、外鏈與頁面體檢接到 Agent 工具鏈上；數據底層來自 DataForSEO，按次從 CallAI 賬戶餘額扣費，每次工具返回裏會標明 billed_usd。同一套能力也可直連遠程 MCP https://api.callaiapi.com/mcp，本文側重 DSH 插件安裝與用法。
這是什麼¶
維護者爲 hanshengcc。插件在 DSH 側註冊 MCP 客戶端並附帶 callai-seo skill，教 Agent 做關鍵詞研究、競品分析、GEO 相關檢查與頁面審計。社區目錄頁：skillhub.cn/plugins/hanshengcc/callai-seo-mcp。分類上屬於聯網/集成類能力（package 元數據 capabilities 含 mcp-client、skills、tools、credentials）。
核心功能¶
Agent 在 dsh 中可見的工具名爲 mcp__callai__<name>，正常配置下共 11 個工具。下面只列資料中已說明的能力摘要。
| 工具 | 作用（概要） |
|---|---|
google_serp / bing_serp |
按關鍵詞取排名結果；Google 結果可含 AI Overview 文本及其引用來源 |
keyword_overview |
批量關鍵詞：搜索量、CPC、競爭度、難度 0–100、主意圖等 |
keyword_ideas |
由種子詞擴展長尾，可按難度上限過濾 |
ranked_keywords |
某域名在有機搜索中排名的關鍵詞及預估流量 |
domain_overview |
域名有機流量、排名詞數量、位置分佈、付費搜索概覽 |
keyword_gap |
競品有排名、己方域名沒有的關鍵詞差距 |
backlinks_summary / referring_domains |
外鏈概況、引用域列表（含 spam score 等） |
page_audit |
指定 URL 的 on-page 檢查與評分 |
dataforseo_request |
對 DataForSEO API 的通用請求（高級用法） |
除 backlink 與 audit 類工具外，多數工具支持 location_code 與 language_code，用於指定市場與語言（詳見倉庫 README 第 6 節）。
計費方式：在 callaiapi.com 註冊後充值（資料寫明最低可從 $1 起），創建 sk-live-… 形式的 API Key；無訂閱制，餘額不過期，按調用扣費。
安裝與啓用¶
需要 dsh 0.2.0 或更高版本（package.json 中 engines 爲 dsh >= 0.2.0-rc.2）。
1、安裝插件（將 web 換成你實際使用的 profile，可用 ls ~/.dsh/profiles 查看）：
dsh plugin --profile web add @callaiapi/seo
也可從 dsh-plugin-shop 等插件商店安裝同一 npm 包。安裝後需重啓 dsh，新插件不會注入已在運行的進程。
2、配置 API Key。插件按下列順序取第一個有效值：
| 來源 | 說明 |
|---|---|
插件配置 apiKey |
profile 下 cordis.patch.yml，或部分 dsh 構建提供的插件設置頁 |
憑證 CALLAI_API_KEY |
dsh 憑證、~/.dsh/.credentials.yaml 的 refs，或 ~/.dsh/.env |
環境變量 CALLAI_API_KEY |
例如 CALLAI_API_KEY=sk-live-… dsh web |
在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中示例：
- id: callai-seo
config:
apiKey: sk-live-your-key
或在 ~/.dsh/.env：
CALLAI_API_KEY=sk-live-your-key
通過 dsh 保存憑證會自動重連；改 patch、.env 或環境變量後需重啓 dsh。
3、獲取 Key：在 https://callaiapi.com/register 註冊，充值後在 https://callaiapi.com/portal?tab=keys 創建 Key，可爲單個 Key 設置 spend limit。
4、自檢：啓動會話後問 Agent「Which mcp__callai tools do you have?」，應列出 11 個工具；再問「Audit https://example.com」應返回真實數據且含 billed_usd。
可選插件配置（默認值見 README）：
| 配置項 | 默認 | 含義 |
|---|---|---|
apiKey |
空 | 爲空則走憑證或環境變量 |
url |
https://api.callaiapi.com/mcp |
MCP 端點 |
toolCallTimeoutMs |
120000 |
單次調用超時；深度 SERP/外鏈可能接近一分鐘 |
卸載：
dsh plugin --profile web remove @callaiapi/seo
典型用法¶
不需要手動點選工具名，用自然語言描述任務即可，由 Agent 選工具。README 中的示例可直接復現：
- 「Find long-tail keywords about standing desks for the UK with difficulty under 30, then check who ranks for the top three.」
- 「Compare my site example.com with competitor.com: traffic, the keywords they rank for that I don’t, and backlink strength.」
- 「Does Google show an AI Overview for ‘best crm for startups’? Which sites does it cite, and is mine one of them?」
- 「Audit https://example.com/pricing and give me a fix list.」
- 「I’m about to buy the expired domain old-brand.com. Check its backlinks and spam score.」
- 「Get search volume and CPC for these 40 keywords in Germany, German language: …」
中文場景下同樣可用中文提問，只要意圖對應上述能力即可。
適用場景與注意¶
適合：在 DSH 裏做 SEO/內容調研、競品關鍵詞差距、AI Overview 引用分析、買域名前查外鏈與 spam、落地頁 on-page 清單等需要實時搜索數據的 Agent 工作流。
注意：
- 插件以當前 dsh 進程的用戶權限運行；安裝前請自行查看 GitHub 源碼 與 MIT 許可證（package.json），確認符合你的安全與合規要求。
- 每次調用消耗 CallAI 餘額，深 SERP 或大批量關鍵詞成本會上升；結果中的
billed_usd用於覈對單次費用。 - DeepSeek Harness 社區目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件星標與版本以倉庫與 npm 爲準（當前 npm 版本 0.1.0）。
結尾¶
CallAI SEO MCP 把「猜 SEO」換成可計費的實時 DataForSEO 數據，並在 DSH 裏用 skill 引導 Agent 組合 11 個 MCP 工具。目錄頁：https://www.skillhub.cn/plugins/hanshengcc/callai-seo-mcp；源碼與完整工具參數：https://github.com/hanshengcc/callai-seo-mcp（含 中文 README）。
