用途:面向开发者,在 GitHub、Stack Overflow、Hacker News、HuggingFace 四个平台搜索代码示例、开源项目、GitHub Issue、技术问答、开发者讨论及 HuggingFace 模型/数据集/Space。
主要能力与脚本:github_search.py 搜索仓库、代码、Issue;stackoverflow_search.py 搜索技术问答,可按 relevance/votes/creation/activity 排序并支持 --tagged 标签过滤;hackernews_search.py 搜索技术新闻和讨论,支持 relevance/date 排序与 story、comment、ask_hn、show_hn 标签;huggingface_search.py 搜索 models、datasets、spaces。输出均为标准 JSON,含 success、query、provider、items、error。
使用方式:各脚本通过 python3 scripts/<脚本名>.py <query> [选项] 调用,通用选项含 --limit/-n(默认 10)。GitHub 的 --type code 必须提供 token(--token 或 GITHUB_TOKEN),否则返回 401;repositories 和 issues 无需 token,有 token 可提高限额。Stack Overflow 可选 SO_API_KEY,HuggingFace 可选 HF_TOKEN。凭证建议写入根目录 .env,由 runtime 或用户加载为同名环境变量。
依赖:首次运行或提示缺库时执行 python3 -m pip install -r requirements.txt,不在脚本内自动安装;安装失败或网络不可用时应停用对应脚本并改用网页搜索。
限制:GitHub 代码搜索强制认证;GitHub 未认证与认证请求的速率限制不同。其他功能、收费与价格信息暂未提供。