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 分