ReefAPI

io.github.reefapi由 GitHub 帳號 reefapi 發布v1.27.2更新於 Oct 24, 2026

One MCP server for 180+ live web-data APIs returning clean JSON from sites that block scrapers.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

ReefAPI 透過一個遠端 MCP 伺服器提供 180 多個即時網路資料 API,讓助理尋找引擎、查看參數結構並呼叫以取得乾淨的 JSON。

可以做什麼
用英文關鍵字或使用情境描述搜尋引擎目錄,或取得依類別分組的完整目錄自行挑選引擎。查看單一引擎的精簡動作概覽,再取得某個動作的完整參數細節,包括定價和範例參數。呼叫引擎動作,傳回統一的 JSON 信封,包含資料、中繼資訊和錯誤。
適用情境
適合助理需要從阻擋爬蟲的網站取得結構化網路資料的情境,例如技術堆疊辨識、公司評價、套件漏洞檢查或網域可用性查詢,並且希望用一把金鑰涵蓋多種資料來源,而不是分別整合。
執行需求
遠端 streamable HTTP 端點 api.reefapi.com。需要 ReefAPI 帳號和 API 金鑰,以 bearer 權杖形式放在 Authorization 標頭中;說明中也提到本機伺服器讀取 REEFAPI_KEY 變數,託管伺服器接受 OAuth 存取權杖。需要網路存取。
安裝前請注意
API 金鑰是放在 Authorization 標頭中的機密,應避免出現在日誌和共享紀錄中。引擎動作可能按次計費,反覆呼叫會產生費用,呼叫前請查看動作結構中的定價。呼叫會把查詢和參數傳送到 ReefAPI 的伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ReefAPI,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.reefapi%2Freefapi-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "reefapi": {
      "type": "http",
      "url": "https://api.reefapi.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

該儲存庫沒有 README。

工具

5

search_engines

Search ReefAPI engines

Find the right ReefAPI engine for a task — pass ENGLISH keywords or a short natural-language use-case ("detect a website's tech stack", "company reviews", "check a package for vulnerabilities", "is this domain available"). The catalog is in English: if the end-user asked in another language, translate their INTENT into English keywords first (you are an LLM — do this inline). Ranks engines by how well the query matches each engine's name/title/category/ACTION descriptions (stem-matched, so plurals/word-forms still hit). Empty query = list all. Returns name/title/category/actions + match score. Call this FIRST, then get_engine_schema(engine) to pick an action. This is a fast keyword pre-filter — if the right engine isn't in the results (or you want to be sure), call get_catalog and pick from the full list YOURSELF (you semantically match any language/phrasing better than keywords).

輸入參數query

get_engine_schema

Engine schema

COMPACT overview of ONE engine: every action with its description, required params and what it returns — but NOT the full param detail (kept lean so a 90-action engine stays token-cheap). Call this after search_engines to pick the right ACTION, then get_action_schema(engine, action) for that action's full params before call_engine.

輸入參數engine必填

get_action_schema

Action schema

FULL detail for ONE engine action: every parameter (type, required, description, allowed_values dropdown, default, example, min/max), what it returns, pricing, and a ready-to-run example_params. Call this right before call_engine so you send valid params — invalid enum values are rejected with the allowed list.

輸入參數action必填engine必填

call_engine

Call a ReefAPI engine

Call a ReefAPI engine action — POST /<engine>/v1/<action> with `params`. Returns the uniform { ok, data, meta, error } envelope. Get param names from get_engine_schema first. Needs YOUR ReefAPI key. The local server reads REEFAPI_KEY; the hosted server accepts an OAuth access token (connect with OAuth and paste your key once on the consent screen — this is what ChatGPT uses), an `Authorization: Bearer <key>` header, `x-reefapi-key`, or the key in the connection URL (`https://api.reefapi.com/mcp?key=<key>`). Get a key at https://reefapi.com. Failed calls cost no credits.

輸入參數action必填engine必填params

get_catalog

ReefAPI catalog

The FULL ReefAPI catalog — EVERY engine with its one-line title, grouped by category. This is the whole menu (≈ a few thousand tokens); SCAN IT AND PICK THE BEST ENGINE YOURSELF. You are an LLM, so you match the user's intent semantically — across ANY language, typo, or phrasing — far better than a keyword search can. Use this whenever search_engines didn't surface the right engine (or to be sure you didn't miss a better one). After you pick: get_engine_schema(engine) -> get_action_schema -> call_engine.

無需輸入參數。

版本歷史

1
  1. v1.27.2最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。