FineData.ai

FineData MCP 服务

适用于 FineData 网页抓取 API 的 MCP（模型上下文协议）服务。

使 AI Agent（Claude、Cursor、GPT，……）能够获取需要完整浏览器的页面，并返回干净的数据：

• JavaScript 渲染和浏览器操作
• 验证码识别
• 数据中心／ISP／住宅／移动代理
• Markdown 或 JSON 输出（默认使用 Markdown）
• AI 结构化提取
• 本地 stdio 或远程 Streamable HTTP（+ OAuth 2.1）

版本：0.3.1

模式

从普通请求开始。页面需要完整浏览器时，可以使用隐身和代理模式；这些模式比普通请求消耗更多令牌。具体费率请参阅文档或通过 get_usage 查询。Gateway 可能会应用域名策略，覆盖请求的引擎或代理；请以响应中的 tokens_used 为准。

安装

uvx（推荐）

curl -LsSf https://astral.sh/uv/install.sh | sh
FINEDATA_API_KEY=fd_xxx uvx finedata-mcp

pip

pip install finedata-mcp
FINEDATA_API_KEY=fd_xxx finedata-mcp

npx

npx -y @finedata/mcp-server

Cursor

~/.cursor/mcp.json（Windows：%USERPROFILE%\.cursor\mcp.json）：

{
  "mcpServers": {
    "finedata": {
      "command": "uvx",
      "args": ["finedata-mcp"],
      "env": {
        "FINEDATA_API_KEY": "fd_your_api_key_here"
      }
    }
  }
}

Cursor 深层链接（发布后）：通过 MCP 目录／“Add to Cursor”安装。

远程（Streamable HTTP）

{
  "mcpServers": {
    "finedata": {
      "url": "https://mcp.finedata.ai/mcp",
      "headers": {
        "Authorization": "Bearer fd_your_api_key_here"
      }
    }
  }
}

OAuth 2.1（Claude.ai／ChatGPT 连接器）：通过 AS 在 https://api.finedata.ai 注册，在控制台中授权，然后将访问令牌用作 Bearer。

环境变量

变量	必需	默认值	描述
FINEDATA_API_KEY	stdio：是	—	API 密钥
FINEDATA_API_URL	否	https://api.finedata.ai	API 基础 URL
FINEDATA_TIMEOUT	否	180	HTTP 客户端超时时间（秒）
FINEDATA_MCP_HOST	HTTP	0.0.0.0	绑定主机
FINEDATA_MCP_PORT	HTTP	8080	绑定端口
FINEDATA_OAUTH_ISSUER	远程 OAuth	—	AS URL（网关）
FINEDATA_MCP_RESOURCE_URL	远程 OAuth	—	公开 MCP URL
FINEDATA_JWT_SECRET	远程 OAuth	—	验证 aud=mcp JWT

工具

工具	用途
scrape_url	使用 GET 同步抓取，只读（默认使用 Markdown）
send_http_request	通过同一流程同步发送 POST / PUT / PATCH / DELETE 请求
scrape_async	异步任务，GET（默认 formats=['markdown']）
get_job_status	轮询任务状态（Markdown，不是原始 HTML）
cancel_job	取消任务
list_jobs	列出任务
batch_scrape	最多处理 100 个 URL（字符串或 {url,...} 对象）
get_batch_status	批次进度
get_usage	通过 api_tokens_used 查询周期用量

重要参数：use_antibot、proxy_country、proxy_sticky、proxy_profile_id、auto_retry、隐身模式、formats、only_main_content、extract_*。

异步／批量：不支持 csv／xlsx 格式（仅同步支持）。

HTTP 传输

finedata-mcp --transport http --host 0.0.0.0 --port 8080

健康检查：GET /health。受保护资源元数据通过端点对应的路径级 URL 提供——GET /.well-known/oauth-protected-resource/mcp——因为 FINEDATA_MCP_RESOURCE_URL 包含 /mcp 路径。客户端通常会从 401 响应的 WWW-Authenticate 标头中找到该 URL，而不是自行猜测。

支持

• 文档：https://finedata.ai/docs
• 问题反馈：https://github.com/quality-network/finedata-mcp/issues

许可证

MIT