exa-search

Exa 検索の統合

クイックリファレンス

トピック	使用する場面	リファレンス
検索モード	自動、ニューラル、キーワード検索から選ぶとき	search-modes.md
フィルター	ドメイン、日付、テキスト、カテゴリーで絞り込むとき	filters.md
コンテンツ	テキスト抽出、ハイライト、要約、ライブクロール	contents.md
SDK のパターン	Python（exa_py）と TypeScript（exa-js）の使用	sdk-patterns.md

基本的なパターン

基本的な検索（Python）

from exa_py import Exa

exa = Exa(api_key="your-api-key")  # or set EXA_API_KEY env var

results = exa.search_and_contents(
    "latest developments in quantum computing",
    type="auto",
    num_results=10,
    text=True,
    highlights=True
)

for result in results.results:
    print(f"{result.title}: {result.url}")
    print(result.text[:500])

基本的な検索（TypeScript）

import Exa from "exa-js";

const exa = new Exa(process.env.EXA_API_KEY);

const results = await exa.searchAndContents(
  "latest developments in quantum computing",
  {
    type: "auto",
    numResults: 10,
    text: true,
    highlights: true,
  }
);

results.results.forEach((result) => {
  console.log(`${result.title}: ${result.url}`);
});

フィルターを使った検索

results = exa.search_and_contents(
    "AI startup funding rounds",
    type="neural",
    num_results=10,
    include_domains=["techcrunch.com", "venturebeat.com"],
    start_published_date="2024-01-01",
    text={"max_characters": 2000},
    summary=True
)

類似リンクを検索

similar = exa.find_similar_and_contents(
    "https://example.com/interesting-article",
    num_results=10,
    exclude_source_domain=True,
    text=True
)

検索モードの選択

モード	使用する場面	備考
auto	ほとんどのクエリでのデフォルト	Exa がニューラル検索とキーワード検索を自動で最適化します
neural	自然言語や概念的なクエリ	「とは何か」「方法」「トピックの探索」に最適です
keyword	完全一致、技術用語、名前	特定の製品名、エラーコード、固有名詞に最適です

よくある間違い

1. 概念的なクエリに keyword を使う - ニューラル検索は意図をより適切に理解します。自然言語の質問には auto または neural を使ってください
2. text=True を設定しない - デフォルトでは検索結果として URL のみが返されます。text=True を指定してコンテンツを明示的にリクエストしてください
3. highlights を無視する - ページ全体のテキストをダウンロードせずに関連する抜粋を取得するには、highlights=True を使ってください
4. API キーがない - EXA_API_KEY 環境変数を設定するか、コンストラクターに明示的に渡してください
5. 最初から絞り込みすぎる - 広範な検索から始め、その後にドメインや日付のフィルターを追加して絞り込んでください
6. summary を使わない - RAG アプリケーションでは、summary=True を指定すると、ページ全体のテキストなしで簡潔なコンテキストを取得できます
7. auto モードでスコアが返ると想定する - 関連度スコアが返されるのは type="neural" の場合のみです。auto モードではスコアは含まれません