Exa Web Toolkit は何をしますか?
Exa をバックエンドとしたWebベースの調査タスクのためのスキル:Web検索とURL抽出。Exaのインデックスは高品質なキーワード検索と意味的検索を組み合わせており、科学的、技術的、概念的なクエリに適しています。
ルーティング — 適切な機能を選ぶ
ユーザーのリクエストを読み、以下の機能のいずれかに割り当ててください。コマンドを実行する前に、対応するリファレンスファイルを読んで詳細な指示を確認してください。
| ユーザーがしたいこと | 機能 | 参照先 |
|---|---|---|
| 何かを調べる、トピックを調査する、最新情報を探す | Web検索 | references/web-search.md |
| 特定のURL(Webページ、記事、PDF)のコンテンツを取得する | Web抽出 | references/web-extract.md |
| インストールまたは認証 | セットアップ | 下記 |
判断ガイド
- デフォルトでWeb検索 — トピック検索、調査質問、「Xとは?」といったクエリに対して。トピックが科学的または技術的な場合、
--category "research paper"を渡して学術ソースを優先し、必要に応じて学術ドメインの--include-domains許可リストを使用してください。詳細な二段階学術戦略についてはreferences/web-search.mdを参照。 - URLが指定された場合や、特定のページを読む・取得するよう依頼された場合はWeb抽出を使用。ビルトインのWebFetchよりも、バッチ抽出(複数URLを一度に呼び出し)や学術PDFに対してこちらを優先してください。
学術ソースの優先順位
技術的または科学的なクエリでは、学術・科学ソースを優先してください:
- ブログ記事やニュースよりも、査読付きジャーナル記事や会議録
- 査読版が入手できない場合はプレプリント(arXiv、bioRxiv、medRxiv)
- 商用サイトよりも機関・政府ソース(NIH、WHO、NASA、NIST)
- 二次的な要約よりも一次研究
Exaを学術コンテンツに向けるための2つのレバー:
--category "research paper"は検索結果を学術ソースに偏らせます。--include-domainsに学術許可リスト(arxiv.org、nature.com、pubmed.ncbi.nlm.nih.gov など)を指定してドメインパールを制限します。
厳密に学術的な結果を得るには両方を組み合わせてください。完全なパターンは references/web-search.md を参照。
学術ソースを引用する場合、標準の引用形式に加えて、可能な限り著者名と出版年を含めてください(例:Smith et al., 2025)。DOIがある場合は、DOIリンクを優先してください。
セットアップ
このスキルは exa-py Python SDK を使用します。scripts/ 内のスクリプトは PEP 723 インラインメタデータで依存関係を宣言しているため、個別のインストール手順なしで uv run を使用して直接実行できます:
uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" --help
永続的なインストールを希望する場合:
uv pip install "exa-py>=1.14.0"
認証
すべてのコマンドは EXA_API_KEY 環境変数からAPIキーを読み取ります。Exa APIキーは dashboard.exa.ai/api-keys から取得してください。
まず、プロジェクトルートに .env ファイルが存在し、EXA_API_KEY が含まれているか確認してください。含まれている場合は、それを読み込みます:
dotenv -f .env run -- uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" "your query"
dotenv が利用できない場合は、インストールしてください:uv pip install python-dotenv[cli]。
.env がない場合は、セッション用にキーをエクスポートします:
export EXA_API_KEY="your-key"
任意のスクリプトを --help 付きで実行して確認してください — キーが設定されていればクリーンに終了し、認証チェックは実際のクエリが行われた場合のみ実行されます。
トラッキングヘッダー
このスキルのすべてのスクリプトは、x-exa-integration リクエストヘッダーを k-dense-ai--scientific-agent-skills に設定します。これにより、ExaはK-Dense AI scientific-agent-skillsリポジトリからの使用状況をこの統合に帰属させることができます。スクリプトを適応する際に、このヘッダーを削除したり名前を変更したりしないでください。
このスキルのファイル
SKILL.md— このファイル(ルーティングとセットアップ)references/web-search.md— 学術戦略を含む詳細なWeb検索リファレンスreferences/web-extract.md— URLコンテンツ抽出リファレンスscripts/exa_search.py—client.search_and_contentsのCLIラッパーscripts/exa_extract.py—client.get_contentsのCLIラッパー