FineData MCP Server

FineData MCP服务器

MCP（模型上下文协议）服务器 FineData 网页抓取API。

使Claude、Cursor和GPT等AI代理能够抓取任何具有以下功能的网站：

• 反机器人绕过 -Cloudflare、DataDome、PerimeterX等
• JavaScript渲染 -使用Playwright进行全浏览器渲染
• 验证码解决 -reCAPTCHA、hCaptcha、Cloudflare旋转栅门、Yandex
• 代理旋转 -87K多个数据中心、住宅和移动代理
• 智能重试 -通过块检测自动重试
• Markdown输出 -默认情况下返回干净的Markdown（针对AI代理进行了优化）
• AI提取 -使用自然语言提示提取结构化数据（Qwen3-32B）

安装

使用uvx（推荐）

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run directly with uvx
FINEDATA_API_KEY=fd_xxx uvx finedata-mcp

使用pip

pip install finedata-mcp

# Run
FINEDATA_API_KEY=fd_xxx finedata-mcp

使用npx

npx -y @finedata/mcp-server

配置

光标IDE

第一步： 打开光标设置→ MCP

或创建/编辑 ~/.cursor/mcp.json:

macOS/Linux：

mkdir -p ~/.cursor && nano ~/.cursor/mcp.json

窗户：

%USERPROFILE%\.cursor\mcp.json

第二步： 添加FineData MCP服务器：

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

步骤3： 重新启动游标

步骤4： 通过询问代理人进行测试：

“刮擦https://example.com给我看看标题”

替代方案：使用npx（如果未安装uv）

{
  "mcpServers": {
    "finedata": {
      "command": "npx",
      "args": ["-y", "@finedata/mcp-server"],
      "env": {
        "FINEDATA_API_KEY": "fd_your_api_key_here"
      }
    }
  }
}

注： npx需要安装Python 3.10+和uv/pipx。建议使用uvx。

______________________________________________________________________

克劳德桌面

第一步： 打开配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

第二步： 添加MCP服务器：

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

步骤3： 重新启动克劳德桌面

______________________________________________________________________

环境变量

可用工具

scrape_url

使用antibot旁路从任何网页中抓取内容。

scrape_url(
  url: "https://example.com",
  formats: ["markdown"],            # Output: markdown, rawHtml, text, links (default: ["markdown"])
  only_main_content: true,          # Extract main content only (default: true)
  extract_prompt: null,             # AI extraction instruction (e.g. "Extract all product prices")
  use_js_render: false,             # Enable Playwright for SPAs
  stealth_antibot: false,           # Stealth mode for Cloudflare, DataDome (+7 tokens)
  stealth_antibot_headful: false,   # Maximum bypass with real browser (+25 tokens)
  stealth_new: false,               # Experimental engine (+15 tokens)
  use_residential: false,           # Use residential proxy
  solve_captcha: false,             # Auto-solve captchas
  timeout: 60                       # Timeout in seconds
)

注： MCP服务器默认返回Markdown（不是原始HTML），这是针对AI代理消费进行优化的。

代币成本：

• 基本请求：1个令牌
• 反机器人旁路：+2个令牌
• JS渲染：+5个令牌
• 隐形反机器人：+7个代币
• 隐形人头：+25个代币
• 隐形新：+15个代币
• 住宅代理：+3个代币
• 验证码破解：+10个令牌

scrape_async

为长时间运行的请求提交异步抓取作业。

scrape_async(
  url: "https://heavy-site.com",
  use_js_render: true,
  timeout: 120,
  callback_url: "https://your-webhook.com/callback"
)

返回a job_id 用于状态轮询。

get_job_status

获取异步抓取作业的状态。

get_job_status(job_id: "550e8400-e29b-41d4-a716-446655440000")

状态： pending, processing, completed, failed, cancelled

batch_scrape

一次性删除多个URL（最多100个URL）。

batch_scrape(
  urls: ["https://example.com/1", "https://example.com/2"],
  use_js_render: false,
  callback_url: "https://your-webhook.com/batch-done"
)

获取_使用

获取当前API令牌使用情况。

get_usage()

例子

基本报废

问问克劳德或你的人工智能代理：

“刮擦https://example.com并向我展示内容”

JavaScript渲染页面

“刮擦https://spa-website.com启用JavaScript渲染”

受验证码保护的网站

“刮擦https://protected-site.com使用住宅代理和验证码解决”

AI数据提取

“刮擦https://shop.com/products并提取所有产品名称和价格”

批量报废

“删除这些URL：https://example.com/1, https://example.com/2, https://example.com/3"

定价

FineData使用基于代币的定价。每个功能都会添加令牌：

在获取您的API密钥和免费试用代币 finedata.ai.

故障排除

“没有名为finedata_mcp的模块”

安装uv并使用uvx：

curl -LsSf https://astral.sh/uv/install.sh | sh

macOS上的“外部管理环境”

这发生在Homebrew Python上。使用uvx而不是pip：

{
  "command": "uvx",
  "args": ["finedata-mcp"]
}

MCP服务器未出现在游标中

1. 检查 ~/.cursor/mcp.json 语法（有效的JSON）
2. 确保 FINEDATA_API_KEY 已设置
3. 完全重新启动游标
4. 检查光标输出→ MCP错误

支持

• 文档：https://finedata.ai/docs
• 电子邮件：support@finedata.ai
• 问题：https://github.com/quality-network/finedata-mcp/issues

许可证

麻省理工学院