開發者 API 與 MCP

Carver 提供公開 REST API 及 MCP（Model Context Protocol）伺服器，讓 AI 代理、AI 聊天工具或你的程式直接接入我們的香港痛點資料 —— 搜尋痛點、生成研究簡報，以及向 AI 商業顧問提問。

取得 API 金鑰

以 Pro 帳戶登入 → 我的帳戶 → 「API 存取（MCP）」→ 建立金鑰（只會顯示一次）。讀取類工具開放給任何有效金鑰；AI 工具（研究簡報、商業顧問）需要 Pro 並計入每月用量。

驗證

在每個請求的標頭加入：

Authorization: Bearer if_live_…

MCP 伺服器

以 JSON-RPC 2.0（Streamable HTTP）POST 至以下端點，支援 initialize、tools/list、tools/call。

POST https://carverhk.com/api/mcp

可用工具

search_painpoints	Search pain points (safe summaries; public lagged surface).
get_painpoint	Get one pain point by slug + available market analysis.
list_top_painpoints	Highest-composite-score pain points.
generate_research_brief	Full research brief for a pain point (Pro; quota).
ask_consultant	Ask the AI business consultant one question (Pro; quota).

REST API

GET /api/v1/painpoints?q=&domain=&limit=&sort=	Search / list pain points.
GET /api/v1/painpoints/{slug}	Single pain point.
POST /api/v1/research-brief	Generate a research brief (Pro). Body: { slug, input?, locale? }
POST /api/v1/consultant	Ask the consultant (Pro). Body: { message, locale? }

範例（列出工具）

curl -X POST https://carverhk.com/api/mcp \
  -H "Authorization: Bearer if_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

存取範圍與用量

讀取類端點回傳公開安全介面（有延遲、只含精選欄位），與匿名網頁一致，不含來源可追溯欄位。AI 工具需 Pro 並計入每月研究簡報／對話用量。

每個金鑰設有每日請求上限（超出回傳 429）。

需要完整資料庫、零公開延遲或大量存取？查看自訂 / API 方案 →

機器可讀資源

OpenAPI 規格與 MCP 資訊清單：