Communitygithub.com

オープンコードセットアップ (iamvtor/opencode-setup)

Exaの高度な検索を使って個人ウェブサイトやブログを検索します。個人の視点、ポートフォリオ、個人ブログを探すための完全なフィルターをサポート。個人サイト、ブログ記事、ポートフォリオサイトの検索に使用します。

opencode-setup) とは?

このスキルは、Exa Python SDK を使用して個人ウェブサイトやブログを検索するためのものです。Exa の「personal site」カテゴリに特化しており、独立したブロガーやクリエイターが運営するサイトを効率的に見つけることができます。`ctx_execute` 経由で Exa を呼び出し、タスクエージェントに検索を委譲することで、メインコンテキストの負荷を減らしながら、必要な情報だけを抽出します。サポートされているパラメータには、`query`、`num_results`、`type`(検索の深さを指定)、`include_domains`/`exclude_domains`、日付範囲によるフィルタリング、テキスト内容のハイライトや要約の取得、さらには最新情報を取得するための `livecrawl` オプションなどが含まれます。主に Claude Code, Cursor, Codex などの AI エージェント環境で使用することを想定しており、セットアップには `EXA_API_KEY` 環境変数と `exa-py` パッケージのインストールが必要です。

対応~Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/iamvtor/opencode-setup/tree/HEAD/skills/exa-personal-site-search

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

個人サイト検索(Exa Python SDK)

前提条件

uv pip install exa-py

EXA_API_KEY 環境変数を設定します。APIキーは https://dashboard.exa.ai/api-keys から取得できます。

アプローチ

ctx_execute(language: "python", code: "...") を使用して Exa を呼び出します。Exa 検索をメインコンテキストで実行せず、常にタスクエージェントを生成し、抽出した出力のみを返すようにします。

サポートされるパラメータ

personal site カテゴリは、利用可能なすべてのパラメータをサポートします:

from exa_py import Exa
import os, json

exa = Exa(os.environ["EXA_API_KEY"])

response = exa.search(
    "building side projects indie hacking journey 2025",
    num_results=15,
    category="personal site",
    type="auto",
    exclude_domains=["medium.com"],  # アグリゲーターを除外し、独立したブログを取得
    contents={"highlights": True}
)

results = []
for r in response.results:
    results.append({
        "title": r.title,
        "url": r.url,
        "highlights": getattr(r, 'highlights', [])
    })
print(json.dumps(results, indent=2))

完全なパラメータ一覧

  • query(必須)
  • num_results
  • type("auto", "fast", "instant", "deep-lite", "deep", "deep-reasoning")
  • include_domains / exclude_domains
  • start_published_date / end_published_date(ISO 8601)
  • start_crawl_date / end_crawl_date(ISO 8601)
  • include_text / exclude_text(単一要素の配列のみ;複数要素の場合は 400 エラー)
  • contents={"text": {"max_characters": N}}
  • contents={"highlights": True} / contents={"highlights": {"query": "..."}}
  • contents={"summary": True} / contents={"summary": {"query": "..."}}
  • user_location
  • moderation
  • additional_queries
  • contents={"livecrawl_timeout": 10000, "max_age_hours": 0}(最新コンテンツ用)

関連スキル