Files

Hermes Agent ccc63d1e70 first commit

2026-05-10 13:52:46 +08:00

4.5 KiB

Raw Blame History

name, description

name	description
sn-search-code	搜索开发者资源：GitHub 仓库/代码/Issue、Stack Overflow 问答、Hacker News 讨论、HuggingFace 模型/数据集/Space。触发词：找代码、开源项目、技术问答、预训练模型、GitHub 搜索。不用于：学术论文（用 sn-search-academic）、中文社区（用 sn-search-social-cn）。

sn-search-code - 开发者搜索

搜索 GitHub、Stack Overflow、Hacker News、HuggingFace 四个开发者核心平台。所有脚本无需 API key 即可使用，但 GitHub --type code 搜索是例外（见下方说明）。

依赖

运行脚本前先安装本 skill 的 Python 依赖：

python3 -m pip install -r skills/sn-search-code/requirements.txt

如果项目使用 uv 环境：

uv pip install -r skills/sn-search-code/requirements.txt

可用脚本

脚本	平台	用途	API key
`github_search.py`	GitHub	仓库、代码、Issue 搜索	`code` 类型必须；其他类型可选（提高限额）
`stackoverflow_search.py`	Stack Overflow	技术问答搜索	无需
`hackernews_search.py`	Hacker News	技术新闻和讨论	无需
`huggingface_search.py`	HuggingFace	模型、数据集、Space 搜索	可选 `HF_TOKEN`（提高限额）

参数说明

github_search.py

python3 scripts/github_search.py <query> [选项]

参数	说明	默认值
`query`	搜索关键词（必填）	—
`--limit`, `-n`	返回结果数量	10
`--type`, `-t`	搜索类型：`repositories`, `code`, `issues`, `repo`, `issue`	repositories
`--token`	GitHub Token（也可通过 `GITHUB_TOKEN` 环境变量设置）	—

注意：--type code 必须提供 token。
GitHub API 对代码搜索接口强制要求认证，未提供 token 会返回 401。
repositories 和 issues 类型无需 token，但有 token 可提高速率限制（未认证 10 次/分钟 → 认证 30 次/分钟）。

python3 scripts/github_search.py "machine learning framework" --type repositories --limit 5
python3 scripts/github_search.py "import asyncio" --type code --token ghp_xxx --limit 5
# 或通过环境变量：
GITHUB_TOKEN=ghp_xxx python3 scripts/github_search.py "import asyncio" --type code --limit 5

stackoverflow_search.py

python3 scripts/stackoverflow_search.py <query> [选项]

参数	说明	默认值
`query`	搜索关键词（必填）	—
`--limit`, `-n`	返回结果数量	10
`--sort`	排序方式：`relevance`, `votes`, `creation`, `activity`	relevance
`--tagged`	按标签过滤，多个用分号分隔（如 `python;asyncio`）	—
`--api-key`	Stack Exchange API key（也可通过 `SO_API_KEY` 环境变量设置，可选，提高限额）	—

python3 scripts/stackoverflow_search.py "python async await" --limit 5
python3 scripts/stackoverflow_search.py "rust lifetime" --sort votes --tagged rust --limit 10

huggingface_search.py

python3 scripts/huggingface_search.py <query> [选项]

参数	说明	默认值
`query`	搜索关键词（必填）	—
`--limit`, `-n`	返回结果数量	10
`--type`, `-t`	搜索类型：`models`, `datasets`, `spaces`（及别名 `model`, `dataset`, `space`）	models
`--token`	HuggingFace Token（也可通过 `HF_TOKEN` 环境变量设置，可选，提高限额）	—

python3 scripts/huggingface_search.py "bert" --type models --limit 5
python3 scripts/huggingface_search.py "text classification" --type datasets --limit 5
python3 scripts/huggingface_search.py "stable diffusion" --type spaces --limit 5

hackernews_search.py

python3 scripts/hackernews_search.py <query> [选项]

参数	说明	默认值
`query`	搜索关键词（必填）	—
`--limit`, `-n`	返回结果数量	10
`--sort`	排序方式：`relevance`, `date`	relevance
`--tags`	HN 标签过滤：`story`, `comment`, `ask_hn`, `show_hn`	—

python3 scripts/hackernews_search.py "LLM agents" --limit 10
python3 scripts/hackernews_search.py "GPT-5" --sort date --tags story --limit 5

输出格式

所有脚本输出标准 JSON：

{
  "success": true,
  "query": "...",
  "provider": "github|stackoverflow|hackernews",
  "items": [
    {"title": "...", "url": "...", "snippet": "...", ...}
  ],
  "error": null
}

4.5 KiB Raw Blame History Unescape Escape