HuntAPI

com.huntapi由 huntapi.com 發布官方發布者v0.1.0更新於 Nov 7, 2026

Download video and audio from public media URLs, or extract their metadata, with one async REST API.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取媒體與設計

概覽

AI 產生的概覽

HuntAPI 讓助理從公開媒體網址下載影片與音訊、擷取媒體中繼資料，並透過託管或本機 MCP 伺服器追蹤非同步工作。

可以做什麼
  • 從媒體網址下載影片或音訊並取得非同步工作 ID
  • 輪詢工作狀態與進度，或等待下載工作完成
  • 不下載檔案即擷取媒體網址的中繼資料
  • 查詢帳戶的即時用量統計與點數餘額
  • 查詢某個引擎或端點過去一小時的基礎設施健康狀態
適用情境
適合需要讓助理從公開網址取得影片或音訊檔案、在下載前檢視媒體中繼資料，或管理長時間執行的下載工作並查看剩餘點數的情境。
執行需求
需要 HuntAPI API 金鑰，註冊後從儀表板複製。託管端點 mcp.huntapi.com 透過 x-api-key 標頭傳送金鑰；本機 npm 套件需要 Node.js 20 或更新版本，並以 HUNTAPI_API_KEY 提供金鑰。需要可連線至 HuntAPI API 的網路。
安裝前請注意
所有呼叫 API 的工具都會消耗點數，使用會產生費用。API 金鑰屬於機密，透過 HUNTAPI_API_KEY 或 x-api-key 標頭傳遞，請勿外洩。stats 工具不受你的帳戶範圍限制，且可能被停用（回應 HTTP 403）。從網站取得的內容不可信。自架的 HTTP 模式在對外開放前應置於 TLS 之後。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "huntapi": {
      "type": "http",
      "url": "https://mcp.huntapi.com/"
    }
  }
}

README

HuntAPI MCP Server

Official Model Context Protocol server for the HuntAPI media download API.

Download video and audio from public media URLs, or extract their metadata, with one async REST API.

It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).

Requirements

  • Node.js 20 or newer
  • a HuntAPI API key — sign up, then copy it from the dashboard

Hosted server (recommended)

HuntAPI runs this server for you at https://mcp.huntapi.com/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.

sh
claude mcp add --transport http huntapi https://mcp.huntapi.com/ --header "x-api-key: YOUR_API_KEY"
json
{  "mcpServers": {    "huntapi": {      "url": "https://mcp.huntapi.com/",      "headers": {        "x-api-key": "YOUR_API_KEY"      }    }  }}

The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.

Run it locally

Claude Code

sh
claude mcp add huntapi --env HUNTAPI_API_KEY=YOUR_API_KEY -- npx -y @huntapi/mcp

Claude Desktop, Cursor, Windsurf and other clients

Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):

json
{  "mcpServers": {    "huntapi": {      "command": "npx",      "args": ["-y", "@huntapi/mcp"],      "env": {        "HUNTAPI_API_KEY": "YOUR_API_KEY"      }    }  }}

VS Code

json
{  "servers": {    "huntapi": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@huntapi/mcp"],      "env": {        "HUNTAPI_API_KEY": "${input:huntapi-api-key}"      }    }  },  "inputs": [    {      "type": "promptString",      "id": "huntapi-api-key",      "description": "HuntAPI API key",      "password": true    }  ]}

Claude Desktop extension

Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.

Docker

sh
docker build -t huntapi-mcp .docker run -i --rm -e HUNTAPI_API_KEY=YOUR_API_KEY huntapi-mcp

Tools

ToolDescription
audio_downloadDownload audio from a URL via HuntAPI and receive a job id.
jobsPoll status, progress (0–100), and result of an async HuntAPI job.
media_metadataExtract metadata from a media URL without downloading the file.
statsInfrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it.
usageRetrieve real-time usage statistics and credit balance for your Huntapi account.
video_downloadVideo Download
wait_for_jobWait for an async download job to finish.

Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.

Streamable HTTP

sh
npx @huntapi/mcp --http --port 3000

The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.

createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):

ts
import { createHttpHandler } from "@huntapi/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

Security

  • The API key is read from HUNTAPI_API_KEY (stdio) or the request headers (HTTP) and removed from error messages.
  • Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
  • See SECURITY.md to report a vulnerability.

Development

sh
npm installnpm testnpm run buildnpx @modelcontextprotocol/inspector node dist/stdio.js

Built on the SDK

The server uses the official Node.js SDK (@huntapi/sdk).

All HuntAPI SDKs

SDKPackageInstall
Node.js@huntapi/sdknpm install @huntapi/sdk
Pythonhuntapipip install huntapi
Gohuntapi-gogo get github.com/huntapi/huntapi-go
.NETHuntApidotnet add package HuntApi
Rubyhuntapigem install huntapi
PHPhuntapi/sdkcomposer require huntapi/sdk
Javahuntapi-javabuild from source, see its README
CLI@huntapi/clinpm install -g @huntapi/cli
MCP server@huntapi/mcpnpx -y @huntapi/mcp

License

MIT — see LICENSE.

來源：README.md，提交 306d1c9

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.1.0最新Nov 7, 2026

評分

已滿足適用檢查項的 85%

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

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

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分