English Français العربية

FineData

Registre officiel Recherche et web

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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.>'
Configuration 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
Configuration 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"
            }
        }
    }
}

Variables d'environnement

  • FINEDATA_API_KEY obligatoire secret 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • FINEDATA_API_KEY obligatoire secret FineData API key (fd_…)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que FineData ?

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

Comment installer FineData ?

Il fonctionne comme serveur distant. Dans 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.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour FineData ?

Oui. Il attend FINEDATA_API_KEY, Authorization, à renseigner dans sa configuration.

FineData est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient FineData ?

Il est publié par quality-network. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.