FineData.ai

FineData MCP サーバー

FineData ウェブスクレイピング API 用の MCP（Model Context Protocol）サーバーです。

AI エージェント（Claude、Cursor、GPT など）が、完全なブラウザーを必要とするページを取得し、整形されたデータを返せるようにします。

• JavaScript のレンダリングとブラウザー操作
• CAPTCHA の解決
• データセンター／ISP／住宅用／モバイルプロキシ
• Markdown または JSON 出力（デフォルトは Markdown）
• AI による構造化抽出
• ローカルの stdio またはリモートの Streamable HTTP（+ OAuth 2.1）

バージョン：0.3.1

モード

まずは通常のリクエストから始めてください。ページに完全なブラウザーが必要な場合は、ステルスモードとプロキシモードを利用できます。これらは通常のリクエストより多くのトークンを消費します。料金の詳細はドキュメントおよび get_usage で確認できます。ゲートウェイは、指定されたエンジンやプロキシを上書きするドメイン戦略を適用する場合があります。レスポンスの 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 コネクター）：https://api.finedata.ai で AS 経由の登録を行い、キャビネットで同意した後、アクセス トークンを 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 ヘッダーからこの情報を取得します。

サポート

• ドキュメント：https://finedata.ai/docs
• 問題の報告：https://github.com/quality-network/finedata-mcp/issues

ライセンス

MIT