Communitygithub.com

iamvtor/opencode-setup

使用 Exa 進階搜尋來搜尋個人網站和部落格。支援完整的篩選器,可用於尋找個人觀點、作品集和個人部落格。適用於搜尋個人網站、部落格文章或作品集網站。

opencode-setup 是什麼?

這個技能讓 AI Agent 能夠透過 Exa Python SDK 進行個人網站和部落格的進階搜尋。與一般網頁搜尋不同,它專注於個人網站類別,能有效找到獨立觀點、作品集和個人部落格。支援完整的搜尋參數,包括排除聚合網站(如 medium.com)、依日期過濾、啟用內容摘要與高亮標記,並可指定搜尋深度(快速、即時、深度等)。工作流程上,強烈建議透過 `ctx_execute` 以 Python 程式碼執行搜尋,並讓 Task Agent 回傳濃縮後的結果,避免在主脈絡進行大量 API 呼叫。主要支援 Claude Code、Coda 等支援 Python 執行的 AI Agent 平台。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

個人網站搜尋 (Exa Python SDK)

必要條件

uv pip install exa-py

設定 EXA_API_KEY 環境變數。取得金鑰請至 https://dashboard.exa.ai/api-keys

方法

使用 ctx_execute(language: "python", code: "...") 來呼叫 Exa。切勿在主脈絡中直接執行 Exa 搜尋——一律產生只回傳濃縮輸出的 Task Agent。

支援的參數

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}(用於取得即時內容)

相關技能