Trawlia

trawlia-mcp

MCP サーバーとしての Trawlia：ニュース検索、ウェブ検索、ページ抽出を、あらゆる MCP クライアントから呼び出せる 2 つのツールとして提供します。

trawlia.co/signup で無料のキーを取得できます。毎月 1,000 クレジットを利用でき、カードは不要です。

Claude Code

claude mcp add trawlia --env TRAWLIA_API_KEY=twl_... -- npx -y trawlia-mcp

Claude Desktop、Cursor、その他の JSON 設定を読み込むもの

{
  "mcpServers": {
    "trawlia": {
      "command": "npx",
      "args": ["-y", "trawlia-mcp"],
      "env": { "TRAWLIA_API_KEY": "twl_..." }
    }
  }
}

ツール

trawlia_search

リアルタイムのウェブから、順位付けされ、重複が除かれた検索結果を返します。

引数	デフォルト	備考
query	必須	キーワードではなく、自然言語で指定します。
search_depth	basic	basic は 1 クレジットで、スニペットを返します。advanced は 2 クレジットで、ページ全体のテキストを返します。
topic	general	news はニュースのインデックスを検索し、公開日を返します。
max_results	すべて	順位付きリストの上位 N 件です。省略すると、見つかった結果がすべて返されます（通常は 20～60 件）。これらはコンテキストに含まれるため、タスクの範囲が狭い場合は設定してください。
include_domains / exclude_domains	-	ホストのフィルターです。サブドメインも含まれます。
time_range	-	day、week、month、year。

trawlia_extract

指定済みの URL を取得し、ナビゲーション、Cookie バナー、ニュースレターのモーダルを除去して、読みやすいコンテンツを返します。 5 URL ごとに 1 クレジットです。リスト全体を一度に渡してください。

モデルに表示される内容

結果は生の JSON ではなく読みやすいテキストで返され、通常の応答では失われる次の 2 つの情報が含まれます。

• ページを読み取れなかった場合、その旨と理由を示します。スニペットを記事であるかのように提示することはありません。
• ソースを利用できなかった場合、カバレッジを示す行が含まれます。これにより、モデルは結果が少ない場合に、何も見つからなかったと確信を持って報告するのではなく、適切に判断できます。

エラーは、再試行する価値があるかどうかを示す読みやすい文で返されます。クレジットがなくなった場合はその旨と再試行しないように伝え、レート制限の場合は待機時間を示します。

料金

操作	クレジット
基本検索	1
高度な検索	2
抽出	URL 5 件ごとに 1

料金は処理の前に請求され、処理が完全に失敗した場合は返金されます。 料金一覧は trawlia.co/pricing をご覧ください。

対応していない機能

検索と抽出のみで、それ以外の機能はありません。クローラーも、ポーリングが必要な長時間実行ジョブもありません。エージェントがサイト全体を巡回する必要がある場合、このサーバーは適していません。

動作確認

TRAWLIA_API_KEY=twl_... node smoke.mjs

実際の API に対して数クレジットを消費し、クライアントに表示される内容（ツール一覧、レンダリングされた検索結果、拒否されたパラメーター、抽出結果）を出力します。 費用がかかり、リアルタイムのウェブに依存するため、CI では実行しません。

環境変数

変数	必須	備考
TRAWLIA_API_KEY	はい	search スコープのキーで十分です。デプロイ時にはこちらを使用してください。
TRAWLIA_BASE_URL	いいえ	デフォルトは https://api.trawlia.co です。ローカルサーバーを指定する場合に使用します。