Octoparse MCP Server

Octoparse MCP Server

English | 日本語

Octoparse MCP Server は、MCP 対応の AI クライアントを Octoparse に接続します。ユーザーはスクレイピングテンプレートの検索、Octoparse のプリセットテンプレートからのクラウドタスクの作成、既存タスクの管理、構造化データのエクスポートを行えます。

ホステッドサーバー

ホステッド Streamable HTTP エンドポイントを使用します。

https://mcp.octoparse.com

これは REST API ツールではなく、MCP サーバーのエンドポイントとして設定してください。

認証

ホステッドサーバーは、OAuth と API キー認証の両方を公式にサポートしています。

• OAuth：MCP クライアントでブラウザー認証フローを開ける場合のデフォルトの方法です。
• API キー：カスタム HTTP ヘッダーを送信できるクライアント向けの任意の認証方法です。

API キー方式では、x-api-key ヘッダーにキーを指定してください。実際のキーをソース管理、問題報告、スクリーンショット、共有ログに含めないでください。

クイックスタート

汎用 HTTP MCP の設定：

{
  "mcpServers": {
    "octoparse": {
      "type": "http",
      "url": "https://mcp.octoparse.com"
    }
  }
}

Claude OAuth／デフォルト認証：

claude mcp add --transport http octoparse https://mcp.octoparse.com

API キーを使用する Claude：

claude mcp add --transport http octoparse https://mcp.octoparse.com --header "x-api-key: YOUR_API_KEY"

Codex CLI：

codex mcp add octoparse --url https://mcp.octoparse.com

Gemini CLI の設定例：

{
  "mcpServers": {
    "octoparse": {
      "httpUrl": "https://mcp.octoparse.com",
      "oauth": {
        "clientId": "Octoparse",
        "enabled": true
      }
    }
  }
}

サーバーを追加した後、クライアントから OAuth を求められた場合は、ブラウザーで認証を完了してください。

その他のクライアントの例については、設定を参照してください。

ツール

ツール	目的
search_templates	キーワード、テンプレート ID、またはスラッグで Octoparse のテンプレートを検索します。
execute_task	パラメーターを検証し、Octoparse のプリセットテンプレートからクラウドタスクを作成して、抽出を開始します。
export_data	データの準備ができたら、タスクの結果を JSON、CSV、Excel、HTML、または XML としてエクスポートします。
search_tasks	認証済みアカウントの既存タスクを検索します。
start_or_stop_task	タスク ID を指定して、既存のクラウドタスクを開始または停止します。
redeem_coupon_code	ユーザーから提供されたプロモーションコード、クーポンコード、またはリソースコードを引き換えます。

入力、例、よくある失敗については、ツールを参照してください。

一般的なワークフロー

search_templates -> execute_task -> export_data

ユーザープロンプトの例：

Find a cloud-capable Octoparse template for Amazon product listings, run it for wireless earbuds, and export the result as CSV.

既存のタスクには、次を使用します。

search_tasks -> export_data

スケジュール設定、通知、定期ジョブ、外部自動化は、MCP クライアントまたは別の自動化システムが処理します。MCP サーバーはタスクとエクスポートのツールを提供しますが、単独で動作するスケジューラーは提供しません。

対応範囲

Octoparse MCP Server では、次の操作が可能です。

• Octoparse のテンプレートライブラリを検索します。
• Octoparse のプリセットテンプレートから、クラウドで実行可能なタスクを作成して実行します。
• 実行前にテンプレートのパラメーターを検証します。
• タスクでデータを取得できるようになったら、そのデータをエクスポートします。
• 既存のクラウド対応タスク（既存のクラウド対応カスタムタスクを含む）を検索、開始、停止、監視、エクスポートします。

次の操作はできません。

• ホステッドサーバーを通じて、ローカルでのみ実行できるデスクトップタスクを実行すること。
• 完全にカスタムのスクレイピングタスクを作成すること。
• カスタムフィールド、ページネーションルール、ループロジック、ブラウザーワークフロー、抽出ステップなど、カスタムタスク設定の詳細を作成または編集すること。
• プライベートテンプレートをアップロードすること。
• 請求またはアカウント管理ツールを提供すること。
• 単独で定期実行をスケジュールすること。

一般的な制限事項

• 一部のテンプレートはローカルでのみ実行でき、Octoparse デスクトップアプリで実行する必要があります。
• クラウドでの実行は、アカウント権限、利用可能なクレジットまたはクォータ、対象サイトの状態、テンプレートの対応状況によって異なります。
• 実行時間の長いタスクでは、追加の呼び出しが必要になることがあります。データの収集またはエクスポートが続いている場合は、待ってから export_data を再度呼び出してください。
• includeTools または excludeTools URL パラメーターを使用して、利用可能なツールを限定できます。概要を参照してください。

セキュリティ

• API キーと OAuth トークンを Git、ログ、スクリーンショット、公開の問題報告に含めないでください。
• 対話型クライアントでは、可能な限り OAuth を使用してください。
• x-api-key は、ヘッダーを安全に保存できるクライアントでのみ使用してください。
• 脆弱性は非公開で報告してください。セキュリティを参照してください。

ドキュメント

• 概要
• 設定
• ツール
• トラブルシューティング
• Octoparse API ドキュメント
• ヘルプセンター
• Smithery で利用可能

開発

npm install
npm run build
npm test

ローカル環境変数を設定するには、.env.example を .env にコピーし、環境に必要な値だけを入力してください。.env は絶対にコミットしないでください。

貢献

貢献を歓迎します。イシューやプルリクエストを作成する前に、CONTRIBUTING.md をお読みください。

ライセンス

MIT。詳細は LICENSE.md をご覧ください。