開発者ガイド

Crawlora MCP 連携ガイド

MCP 対応クライアントやエージェントネイティブなワークフローを、Crawlora のホスト型 Streamable HTTP エンドポイントに接続し、構造化された公開ウェブデータ用ツールを利用できます。

ホスト型 MCP エンドポイントStreamable HTTP構造化ツールサーバー側キー

ホスト型 MCP エンドポイント

https://mcp.crawlora.net/mcp

Streamable HTTP

接続

URL: https://mcp.crawlora.net/mcp
Transport: Streamable HTTP
Auth header: Authorization: Bearer $CRAWLORA_API_KEY
Server card: https://crawlora.net/.well-known/mcp/server-card.json

MCP URL

https://mcp.crawlora.net/mcp

トランスポート

Streamable HTTP

認証ヘッダー

Authorization: Bearer

Crawlora は https://mcp.crawlora.net/mcp でホスト型 MCP エンドポイントを公開しています。MCP 対応クライアントを Streamable HTTP トランスポートで構成し、サーバー側の Crawlora API キーを Authorization: Bearer として同じように渡します。MCP エンドポイントは、カスタムヘッダーに対応するクライアント向けに x-api-key も受け付けます。

開発者ワークフロー

MCP がウェブデータのワークフローにもたらすもの

MCP を使うと、AI クライアントはサーバーが公開するツールを発見して呼び出せます。Crawlora のエージェントネイティブな API は、対応エンドポイントが明確な入力と構造化された JSON 出力を持つため、このモデルに適しています。

開発者ワークフロー

Crawlora を MCP と組み合わせて使う場面

AI リサーチアシスタント。
SERP 調査ツール。
ローカルビジネスおよびジオコーディングの調査エージェント。
旅行・ホスピタリティの調査エージェント。
不動産市場の調査エージェント。
レビューと評判の要約エージェント。
アプリレビューの要約エージェント。
YouTube の文字起こしエージェント。
TikTok のトレンド調査エージェント。
音楽カタログの調査エージェント。
ポッドキャスト・音声の調査エージェント。
E コマースのモニタリングエージェント。

開発者ワークフロー

ホスト型 MCP に接続する

クライアントがリモートの Streamable HTTP MCP サーバーに対応している場合は、ホスト型エンドポイントを直接利用してください。

Endpoint: https://mcp.crawlora.net/mcp。
Transport: Streamable HTTP。
推奨される認証ヘッダー: Authorization: Bearer。
代替の認証ヘッダー: x-api-key。
サーバーカード: https://crawlora.net/.well-known/mcp/server-card.json。
API キーが欠落または無効な場合は 401 を返します。

開発者ワークフロー

接続値

これらの値を MCP 対応ホストで使用してください。API キーはモデルから見えるプロンプトやブラウザコードの外に保持してください。

Add the connector

In ChatGPT or Claude's custom connector settings, add a new connector and paste https://mcp.crawlora.net/mcp as the server URL.

Client discovers OAuth automatically

The client fetches the endpoint's protected-resource metadata, follows it to Crawlora's authorization server at https://crawlora.net, and registers itself with Dynamic Client Registration — no manual client setup or API key entry.

Sign in and approve access

You're redirected to sign in to your Crawlora account (or use an existing session) and approve the connector on a consent screen. No API key is ever pasted into the client.

Start calling tools

The client stores and refreshes its own access token. Disconnect the connector in ChatGPT or Claude at any time to revoke its access.

開発者ワークフロー

ツールを発見して呼び出す

Use these values in MCP-capable hosts that take a manual API key instead of OAuth. Keep the API key outside model-visible prompts and browser code.

Hosted MCP connection · text

MCP URL: https://mcp.crawlora.net/mcp
Transport: Streamable HTTP
Authentication: Authorization: Bearer $CRAWLORA_API_KEY
Alternate auth: x-api-key: $CRAWLORA_API_KEY
Server card: https://crawlora.net/.well-known/mcp/server-card.json

Codex direct HTTP MCP · bash

codex mcp add crawlora \
  --url https://mcp.crawlora.net/mcp \
  --bearer-token-env-var CRAWLORA_API_KEY

Generic MCP client config · json

{
  "mcpServers": {
    "crawlora": {
      "url": "https://mcp.crawlora.net/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer $CRAWLORA_API_KEY"
      }
    }
  }
}

Read server card · bash

curl https://crawlora.net/.well-known/mcp/server-card.json

開発者ワークフロー

連携の選択肢

Add server

Authenticate

Pass the Crawlora API key as Authorization: Bearer from the MCP client or server-side host. Use x-api-key only when the host supports custom headers but not bearer token configuration.

Inspect tools

Let the MCP client list available tools and resources before choosing an endpoint.

Call narrowly

Send only documented inputs for the selected Crawlora tool and cap result sizes where possible.

Handle failures

Surface 401, plan, credit, rate-limit, and upstream errors clearly to the agent-native workflow.

開発者ワークフロー

MCP ツール定義の例

Use the hosted Crawlora MCP endpoint for clients that support remote Streamable HTTP MCP.
Use Crawlora REST APIs directly when your environment does not support remote MCP.
Create your own lightweight MCP server only when you need custom tool filtering, tenancy, auditing, or local policy controls.

開発者ワークフロー

任意の TypeScript ラッパー

このパターンは、Crawlora REST API を独自のポリシーレイヤーの背後でラップするプライベートな MCP サーバーを実行する必要がある場合にのみ使用してください。

Illustrative MCP tool · json

{
  "name": "crawlora_google_search",
  "description": "Search public Google results through Crawlora and return normalized JSON.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "keyword": { "type": "string" },
      "country": { "type": "string" },
      "language": { "type": "string" },
      "limit": { "type": "number" }
    },
    "required": ["keyword"]
  },
  "output": "Crawlora JSON envelope with result items, status, and message fields."
}

開発者ワークフロー

セキュリティチェックリスト

Use this pattern only when you need to run a private MCP server that wraps Crawlora REST APIs behind your own policy layer.

Tool handler · typescript

async function callCrawloraTool(args: {
  keyword: string;
  country?: string;
  language?: string;
  limit?: number;
}) {
  const response = await fetch("https://api.crawlora.net/api/v1/google/search", {
    method: "POST",
    headers: {
      "x-api-key": process.env.CRAWLORA_API_KEY ?? "",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      keyword: args.keyword,
      country: args.country ?? "us",
      language: args.language ?? "en",
      limit: args.limit ?? 10,
      page: 1,
    }),
  });

  if (!response.ok) {
    throw new Error(`Crawlora request failed: ${response.status} ${await response.text()}`);
  }

  return response.json();
}

// Register this handler with the MCP SDK version used by your server.

開発者ワークフロー

エージェント UX のヒント

任意の URL 収集ではなく、絞り込んだツールを公開します。
構造化された JSON を返します。
可能な場合はソースプラットフォームとリクエストのコンテキストを含めます。
失敗状態をエージェントから見えるようにします。
コストを抑えるため結果件数に上限を設けます。

開発者ワークフロー

Agent UX tips

Expose narrow tools, not arbitrary URL collection.
Return structured JSON.
Include source platform and request context where available.
Make failure states visible to the agent.
Cap result counts to control cost.

責任ある公開ウェブデータのワークフロー

Crawlora は構造化された公開ウェブデータのワークフローにご利用ください。お客様は、適用される法令、第三者の権利、プラットフォームのルール、および Crawlora の規約への準拠について責任を負います。API キーはサーバー側に保持し、入力を検証し、不要な機密データの収集や保存は避けてください。

Crawlora の規約を読む

開発者ワークフロー

FAQ

この Crawlora 開発者向け連携パスに関するよくある質問です。

MCP とは何ですか?

Model Context Protocol は、サーバーインターフェースを通じて AI クライアントにツールやリソースを公開するためのパターンです。

Crawlora には公式の MCP サーバーがありますか?

はい。https://mcp.crawlora.net/mcp のホスト型 Streamable HTTP エンドポイントを Authorization: Bearer とともに使用してください。MCP エンドポイントは、カスタムヘッダーに対応するクライアント向けに x-api-key も受け付けます。

Crawlora の API を MCP ツールとしてラップできますか?

はい。絞り込んだ Crawlora の HTTP 呼び出しをサーバー側の MCP ツールの背後でラップし、API キーをサーバー環境に保持してください。

どの Crawlora API が MCP ツールに向いていますか?

Search、Maps、Geocoding、Airbnb、TripAdvisor、Zillow、YouTube、TikTok、App Store、Google Play、Spotify、Spotify Podcasts、Apple Podcasts、Amazon、Product Hunt、Trustpilot、およびレビュー系エンドポイントは、エージェントのタスクに合致する場合に有用な候補です。

API キーはどのように保護すべきですか?

キーはサーバー側に保存し、ツールへのアクセスを制限し、入力を検証し、シークレットのログ記録は避けてください。

MCP ツールはクレジットを消費しますか?

はい。Crawlora API エンドポイントを呼び出すツール呼び出しは、エンドポイントの課金ルールに従ってクレジットを消費する場合があります。

これは LangChain のツールとどう違いますか?

MCP は、クライアントにツールを公開するためのプロトコルに焦点を当てています。LangChain のツールは、LangChain ワークフロー内のフレームワークレベルのラッパーです。

How is this different from LangChain tools?

MCP focuses on a protocol for exposing tools to clients. LangChain tools are framework-level wrappers inside LangChain workflows.

Crawlora MCP に接続する

ホスト型 MCP URL から始め、Authorization: Bearer または x-api-key のフォールバックを検証してから、絞り込んだ検索、旅行、不動産、レビュー、アプリレビュー、ポッドキャスト、音楽カタログのいずれかのツールを呼び出します。

API を見る連携を見る

Crawlora MCP 連携ガイド

ホスト型 MCP エンドポイントStreamable HTTP構造化ツールサーバー側キー

MCP がウェブデータのワークフローにもたらすもの

MCP URL: https://mcp.crawlora.net/mcp Transport: Streamable HTTP Authentication: Authorization: Bearer $CRAWLORA_API_KEY Alternate auth: x-api-key: $CRAWLORA_API_KEY Server card: https://crawlora.net/.well-known/mcp/server-card.json

{ "mcpServers": { "crawlora": { "url": "https://mcp.crawlora.net/mcp", "transport": "streamable-http", "headers": { "Authorization": "Bearer $CRAWLORA_API_KEY" } } } }

{ "name": "crawlora_google_search", "description": "Search public Google results through Crawlora and return normalized JSON.", "inputSchema": { "type": "object", "properties": { "keyword": { "type": "string" }, "country": { "type": "string" }, "language": { "type": "string" }, "limit": { "type": "number" } }, "required": ["keyword"] }, "output": "Crawlora JSON envelope with result items, status, and message fields." }

async function callCrawloraTool(args: { keyword: string; country?: string; language?: string; limit?: number; }) { const response = await fetch("https://api.crawlora.net/api/v1/google/search", { method: "POST", headers: { "x-api-key": process.env.CRAWLORA_API_KEY ?? "", "Content-Type": "application/json", }, body: JSON.stringify({ keyword: args.keyword, country: args.country ?? "us", language: args.language ?? "en", limit: args.limit ?? 10, page: 1, }), }); if (!response.ok) { throw new Error(`Crawlora request failed: ${response.status} ${await response.text()}`); } return response.json(); } // Register this handler with the MCP SDK version used by your server.

責任ある公開ウェブデータのワークフロー

Crawlora の規約を読む

Crawlora MCP に接続する

Crawlora MCP 連携ガイド

MCP がウェブデータのワークフローにもたらすもの

Crawlora を MCP と組み合わせて使う場面

ホスト型 MCP に接続する

接続値

Add the connector

Client discovers OAuth automatically

Sign in and approve access

Start calling tools

ツールを発見して呼び出す

Hosted MCP connection · text

Codex direct HTTP MCP · bash

Generic MCP client config · json

Read server card · bash

連携の選択肢

Add server

Authenticate

Inspect tools

Call narrowly

Handle failures

MCP ツール定義の例

任意の TypeScript ラッパー

Illustrative MCP tool · json

セキュリティチェックリスト

Tool handler · typescript

エージェント UX のヒント

Agent UX tips

責任ある公開ウェブデータのワークフロー

関連する開発者向けリンク

MCP サーバーカード

OpenAI Agents

AI エージェント

TypeScript ガイド

Docs

規約

FAQ

Crawlora MCP に接続する

Crawlora MCP 連携ガイド

MCP がウェブデータのワークフローにもたらすもの

Crawlora を MCP と組み合わせて使う場面

ホスト型 MCP に接続する

接続値

Add the connector

Client discovers OAuth automatically

Sign in and approve access

Start calling tools

ツールを発見して呼び出す

Hosted MCP connection · text

Codex direct HTTP MCP · bash

Generic MCP client config · json

Read server card · bash

連携の選択肢

Add server

Authenticate

Inspect tools

Call narrowly

Handle failures

MCP ツール定義の例

任意の TypeScript ラッパー

Illustrative MCP tool · json

セキュリティチェックリスト

Tool handler · typescript

エージェント UX のヒント

Agent UX tips

責任ある公開ウェブデータのワークフロー

関連する開発者向けリンク

MCP サーバーカード

OpenAI Agents

AI エージェント

TypeScript ガイド

Docs

規約

FAQ

Crawlora MCP に接続する