English Français العربية

FineData

السجل الرسمي البحث والويب

FineData web scraping MCP — JavaScript rendering, captcha solving, markdown for AI agents

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http finedata 'https://mcp.finedata.ai/mcp' --header 'Authorization: <Bearer fd_… API key. Optional: an OAuth 2.1 client discovers the flow from the 401 challenge instead of being asked for a key up front.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "finedata": {
            "type": "http",
            "url": "https://mcp.finedata.ai/mcp",
            "headers": {
                "Authorization": "<Bearer fd_… API key. Optional: an OAuth 2.1 client discovers the flow from the 401 challenge instead of being asked for a key up front.>"
            }
        }
    }
}
PYPI package finedata-mcp
Claude Code 
claude mcp add finedata -e 'FINEDATA_API_KEY=<your finedata_api_key>' -e 'FINEDATA_API_URL=https://api.finedata.ai' -- uvx finedata-mcp==0.3.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "finedata": {
            "command": "uvx",
            "args": [
                "finedata-mcp==0.3.1"
            ],
            "env": {
                "FINEDATA_API_KEY": "<your finedata_api_key>",
                "FINEDATA_API_URL": "https://api.finedata.ai"
            }
        }
    }
}

متغيرات البيئة

  • FINEDATA_API_KEY إلزامي سري FineData API key (fd_…)
  • FINEDATA_API_URL API base URL
NPM package @finedata/mcp-server
Claude Code 
claude mcp add finedata -e 'FINEDATA_API_KEY=<your finedata_api_key>' -- npx -y @finedata/mcp-server@0.3.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "finedata": {
            "command": "npx",
            "args": [
                "-y",
                "@finedata/mcp-server@0.3.1"
            ],
            "env": {
                "FINEDATA_API_KEY": "<your finedata_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • FINEDATA_API_KEY إلزامي سري FineData API key (fd_…)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. FineData MCP Server
  2. Modes
  3. Installation
  4. Cursor
  5. Environment
  6. Tools
  7. HTTP transport
  8. Support
  9. License

FineData MCP Server

MCP (Model Context Protocol) server for FineData web scraping API.

Enables AI agents (Claude, Cursor, GPT, …) to fetch pages that need a full browser and return clean data:

  • JavaScript rendering and browser actions
  • Captcha solving
  • Datacenter / ISP / residential / mobile proxies
  • Markdown or JSON output (markdown by default)
  • AI structured extraction
  • Local stdio or remote Streamable HTTP (+ OAuth 2.1)

Version: 0.3.1

Modes

Start with a plain request. Stealth and proxy modes are available when a page needs a full browser; they consume more tokens than a plain request. Exact rates are in the documentation and via get_usage. Gateway may apply a domain strategy that overrides the requested engine or proxy; trust tokens_used in the response.

Installation

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 deeplink (after publishing): install via MCP directory / “Add to Cursor”.

Remote (Streamable HTTP)
{
  "mcpServers": {
    "finedata": {
      "url": "https://mcp.finedata.ai/mcp",
      "headers": {
        "Authorization": "Bearer fd_your_api_key_here"
      }
    }
  }
}

OAuth 2.1 (Claude.ai / ChatGPT connectors): register via AS at https://api.finedata.ai, consent in the cabinet, then use the access token as Bearer.

Environment

VariableRequiredDefaultDescription
FINEDATA_API_KEYstdio: yes—API key
FINEDATA_API_URLnohttps://api.finedata.aiAPI base
FINEDATA_TIMEOUTno180HTTP client timeout (seconds)
FINEDATA_MCP_HOSTHTTP0.0.0.0Bind host
FINEDATA_MCP_PORTHTTP8080Bind port
FINEDATA_OAUTH_ISSUERremote OAuth—AS URL (gateway)
FINEDATA_MCP_RESOURCE_URLremote OAuth—Public MCP URL
FINEDATA_JWT_SECRETremote OAuth—Verify aud=mcp JWTs

Tools

ToolPurpose
scrape_urlSync scrape with GET, read-only (markdown default)
send_http_requestSync POST / PUT / PATCH / DELETE through the same pipeline
scrape_asyncAsync job, GET (formats=['markdown'] default)
get_job_statusPoll job (markdown, not raw HTML)
cancel_jobCancel job
list_jobsList jobs
batch_scrapeUp to 100 URLs (string or {url,...} objects)
get_batch_statusBatch progress
get_usagePeriod usage via api_tokens_used

Notable parameters: use_antibot, proxy_country, proxy_sticky, proxy_profile_id, auto_retry, stealth modes, formats, only_main_content, extract_*.

Async/batch: no csv/xlsx formats (sync only).

HTTP transport

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

Health: GET /health. Protected resource metadata is served at the path-scoped URL for the endpoint — GET /.well-known/oauth-protected-resource/mcp — because FINEDATA_MCP_RESOURCE_URL carries the /mcp path. Clients normally find it from the WWW-Authenticate header on a 401 rather than guessing.

Support

License

MIT

الأسئلة الشائعة

ما هو FineData؟

FineData web scraping MCP — JavaScript rendering, captcha solving, markdown for AI agents

كيف أثبّت FineData؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http finedata 'https://mcp.finedata.ai/mcp' --header 'Authorization: <Bearer fd_… API key. Optional: an OAuth 2.1 client discovers the flow from the 401 challenge instead of being asked for a key up front.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج FineData إلى مفتاح API؟

نعم. يتطلب FINEDATA_API_KEY, Authorization، وتضبطها في إعداداته.

هل FineData مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون FineData؟

ينشره quality-network. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.