9router-web-search

9Router — ウェブ検索

NINEROUTER_URL が必要です（認証を有効にしている場合は NINEROUTER_KEY も必要です）。セットアップについては、https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router/SKILL.md をご覧ください。

検出

curl $NINEROUTER_URL/v1/models/web | jq '.data[] | select(.kind=="webSearch") | .id'
# Per-provider params (searchTypes, maxResults, required options like cx for google-pse)
curl "$NINEROUTER_URL/v1/models/info?id=tavily/search"

ID は /search で終わります（例：tavily/search）。コンボ（owned_by:"combo"）はプロバイダーを連携し、自動でフォールバックします。

エンドポイント

POST $NINEROUTER_URL/v1/search

フィールド	必須	備考
model（または provider）	はい	/v1/models/web にあるもの（例：tavily または brave）
query	はい	検索クエリ
max_results	いいえ	デフォルトは 5
search_type	いいえ	web（デフォルト）／news／Xquik 用の x
country、language、time_range、domain_filter	いいえ	プロバイダーによって異なります

例

curl -X POST $NINEROUTER_URL/v1/search \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tavily","query":"9Router open source","max_results":5}'

JS：

const r = await fetch(`${process.env.NINEROUTER_URL}/v1/search`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "search-combo", query: "latest LLM benchmarks", max_results: 10 }),
});
console.log(await r.json());

Xquik を使った X 検索：

curl -X POST $NINEROUTER_URL/v1/search \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"xquik","query":"from:github release","max_results":10,"provider_options":{"queryType":"Latest"}}'

9Router のプロバイダー設定に Xquik API キーを追加してください。Xquik は、返された投稿 1 件につき 1 クレジットを消費します。pagination.next_cursor を provider_options.cursor として渡すと、検索を続けられます。

Xquik のレスポンスには、プロバイダーのページネーション情報とクレジット使用量が含まれます。

{
  "pagination": { "has_more": true, "next_cursor": "cursor-2" },
  "usage": { "queries_used": 1, "search_cost_usd": null, "provider_credits_used": 10 }
}

レスポンス形式

{
  "provider": "tavily",
  "query": "9Router open source",
  "results": [
    {
      "title": "...", "url": "https://...", "display_url": "github.com/...",
      "snippet": "...", "position": 1, "score": 0.92,
      "published_at": null, "favicon_url": null, "content": null,
      "metadata": { "author": null, "language": null, "source_type": null, "image_url": null },
      "citation": { "provider": "tavily", "retrieved_at": "2026-...", "rank": 1 }
    }
  ],
  "answer": null,
  "usage": { "queries_used": 1, "search_cost_usd": 0.008 },
  "metrics": { "response_time_ms": 850, "upstream_latency_ms": 700, "total_results_available": 12 },
  "errors": []
}

プロバイダーごとの注意点

すべてのプロバイダーで query と max_results を使用できます。オプションのフィールドはプロバイダーによって異なります。

プロバイダー	対応項目	必須の追加項目
tavily	country、domain_filter、ニュースのトピック	—
exa	domain_filter（含める／除外する）、ニュースのカテゴリ	—
brave-search	country、language	—
serper	country、language、ニュースエンドポイント	—
perplexity	country、language、domain_filter	—
linkup	domain_filter、time_range	depth: fast/standard/deep（オプション）
google-pse	country、language、time_range、offset	cx が必須（providerOptions）
searchapi	country、language、ページネーション	—
youcom	country、language、time_range、domain_filter、full_page	—
searxng	language、time_range	セルフホスト可能、noAuth
xquik	X/Twitter の検索演算子、language、カーソルによるページネーション	queryType: Latest/Top、cursor（オプション）

プロバイダーがモデルです — "provider":"tavily" ≡ "model":"tavily"。