mcpField
E
exa-search

exa-search

github.com/crazymsn生産性2335 回インストール22 週間前に更新
リポジトリ

exa-search について

exa-searchは、Exaを使ったウェブ調査とURLコンテンツ抽出のスキルで、調査や情報収集に向いています。トピック検索と指定ページの取得を使い分け、学術情報の検索方法も案内します。

主な機能

  1. 01トピックや最新情報のウェブ検索
  2. 02指定URLからのコンテンツ抽出
  3. 03検索と抽出の処理振り分け
  4. 04技術検索で学術情報を優先する案内
  5. 05Exa Python SDKによるCLIスクリプト実行

活用シーン

  1. 01科学・技術上の疑問の調査
  2. 02トピックの最新情報の確認
  3. 03ウェブページや学術PDFの内容取得
  4. 04複数の指定URLからの情報抽出

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/crazymsn/academic-skills --skill exa-search

インストール後、Claude Code で/exa-searchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
web-extract.md
web-search.md
scripts/
exa_extract.py
exa_search.py
tests/
test_exa_search.py

詳細

Exa Web Toolkit

Exa を活用したウェブ調査向けスキルです。ウェブ検索と URL 抽出を行います。Exa のインデックスは、高品質なキーワード検索とセマンティック検索を組み合わせているため、科学、技術、概念に関するクエリに適しています。

ルーティング — 適切な機能を選ぶ

ユーザーのリクエストを読み、以下の機能の中から該当するものを選びます。コマンドを実行する前に、詳細な手順について対応するリファレンスファイルを読んでください。

ユーザーの目的機能場所
何かを調べる、トピックを調査する、最新情報を探すWeb Searchreferences/web-search.md
特定の URL（ウェブページ、記事、PDF）の内容を取得するWeb Extractreferences/web-extract.md
インストールまたは認証を行うSetup以下
判断ガイド
  • トピックの検索、調査に関する質問、「X とは何ですか？」というクエリには、Web Search をデフォルトで使用します。トピックが科学または技術に関する場合は、学術情報源が優先されるよう --category "research paper" を指定するか、学術系の --include-domains 許可リストを指定します。2 段階の学術検索戦略については、references/web-search.md を参照してください。
  • ユーザーが URL を提示した場合、または特定のページを読んだり取得したりするよう依頼した場合は、Web Extract を使用します。複数の URL を一度に抽出する場合や、学術論文の PDF を扱う場合は、組み込みの WebFetch よりもこちらを優先してください。
学術情報源の優先順位

技術または科学に関するクエリでは、学術・科学情報源を優先してください。

  • ブログ記事やニュース記事よりも、査読付き学術誌の論文や学会論文を優先
  • 査読済みの論文がない場合は、プレプリント（arXiv、bioRxiv、medRxiv）を優先
  • 商用サイトよりも、機関および政府の情報源（NIH、WHO、NASA、NIST）を優先
  • 二次的な要約よりも、一次研究を優先

Exa の検索結果を学術情報に誘導する方法は 2 つあります。

  1. --category "research paper" を指定すると、学術情報が優先されます。
  2. 学術系の許可リストを --include-domains で指定すると（arxiv.org、nature.com、pubmed.ncbi.nlm.nih.gov など）、検索対象のドメインが制限されます。

厳密に学術情報に絞り込むには、両方を組み合わせてください。詳しい手順については、references/web-search.md を参照してください。

学術情報源を引用する場合は、標準的な引用形式に加えて、入手可能であれば著者名と出版年も含めてください（例：Smith et al., 2025）。DOI がある場合は、DOI リンクを優先してください。

Setup

このスキルでは Exa Python SDK の exa-py を使用します。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"
Authentication

すべてのコマンドは、EXA_API_KEY 環境変数から API キーを読み込みます。dashboard.exa.ai/api-keys で Exa API キーを取得してください。

まず、プロジェクトルートに .env ファイルがあり、EXA_API_KEY が含まれていることを確認します。含まれている場合は、読み込みます。

dotenv -f .env run -- uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" "your query"

dotenv が利用できない場合は、pip install python-dotenv[cli] または uv pip install python-dotenv[cli] でインストールしてください。

.env ファイルがない場合は、このセッション用にキーをエクスポートします。

export EXA_API_KEY="your-key"

--help を指定していずれかのスクリプトを実行し、確認してください。キーが設定されていれば正常に終了し、認証チェックは実際のクエリを実行する場合にのみ行われます。

このスキルのファイル

  • SKILL.md — このファイル（ルーティングとセットアップ）
  • references/web-search.md — 学術検索戦略を含む、ウェブ検索の詳細リファレンス
  • references/web-extract.md — URL コンテンツ抽出のリファレンス
  • scripts/exa_search.py — client.search_and_contents を使った CLI ラッパー
  • scripts/exa_extract.py — client.get_contents を使った CLI ラッパー

コメント

Markdown 対応