Model Context Protocol

Crawl MCP Server

讓任何支援 MCP 的 AI 代理（Cursor、Claude Desktop、Windsurf、Cline 等）直接連接 Crawl API。Agent 可抓取單頁、結構化抽取、深層爬取、搜尋網頁，並即時查詢帳戶餘額。

三步安裝

從 npm 安裝 MCP server

npm install -g @crawl/mcp

npm 套件將在第一次 publish 完成後可用。若尚未找到，請使用下方的 source build。

取得 API key

從 Dashboard 複製一組 API key。明文僅顯示一次。

取得 API key

將下列設定加入你的 MCP client 設定檔

Cursor → Settings → MCP → Add new MCP server

Claude Desktop → Settings → Developer → Edit Config

從原始碼建置

直接從 repository 安裝

git clone https://github.com/winbayai/Crawl.git
cd Crawl/mcp-server
npm install
npm run build
npm link

發布到 npm

若要啟用 npm install，請在 npm 建立組織 @crawl、產生 automation access token，並在 GitHub repo settings 加入 NPM_TOKEN secret。下次 push 到 main 時 CI 會自動 publish。

Client 設定範例

Cursor

Cursor → Settings → MCP → Add new MCP server

{
  "mcpServers": {
    "crawl": {
      "command": "crawl-mcp",
      "args": [],
      "env": {
        "CRAWL_API_KEY": "sk_live_...",
        "CRAWL_API_BASE": "https://api-crawl.top1.ai"
      }
    }
  }
}

Claude Desktop

Claude Desktop → Settings → Developer → Edit Config

{
  "mcpServers": {
    "crawl": {
      "command": "crawl-mcp",
      "env": {
        "CRAWL_API_KEY": "sk_live_...",
        "CRAWL_API_BASE": "https://api-crawl.top1.ai"
      }
    }
  }
}

環境變數

CRAWL_API_KEY=sk_live_...
CRAWL_API_BASE=https://api-crawl.top1.ai

內建工具

scrape

1 credit

將單一 URL 抓取為乾淨 Markdown。

extract

3 credits

透過 LLM 與 JSON schema 抽取結構化資料。

crawl

1 / 頁

於同網域進行 BFS 深層爬取，按實際頁數計費。

search

2 credits

網頁搜尋並可選擇逐項抓取結果內容。

usage

免費

查詢剩餘 credits 與近期用量摘要。

準備好讓你的 agent 瀏覽網頁？

註冊即可獲得 100 free credits 與預設 API key。

取得 API key API 文件