关于 sn-search-social-en
sn-search-social-en 是用于搜索 Reddit、Twitter/X 和 YouTube 英文内容的技能,面向需要查找英文社交讨论与视频的研究者。它通过三个 Python 脚本提供平台对应的搜索参数,并以 JSON 返回结果。
主要功能
- 01搜索 Reddit 帖子与讨论
- 02搜索 Twitter/X 推文
- 03搜索 YouTube 视频
- 04配置结果数量与排序选项
- 05以 JSON 输出搜索结果
适用场景
- 01查找 Reddit 上的主题讨论
- 02检索 Twitter/X 英文推文
- 03按相关性或日期查找 YouTube 视频
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ opensensenova/ sensenova-skills --skill sn-search-social-en安装后在 Claude Code 中输入/sn-search-social-en确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
requirements.txtscripts/reddit_search.pysearch_utils.pytwitter_search.pyyoutube_search.py详细介绍
来自项目 READMEsn-search-social-en - 英文社交平台搜索
凭证配置
API key、token 与 cookie 统一建议写在仓库根目录 .env(参考 .env.example),并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证;不要把真实密钥写入 skill payload、报告、日志或提交。
搜索 Reddit、Twitter/X、YouTube 三个英文社交平台。
可用脚本
| 脚本 | 平台 | 用途 | API 密钥 |
|---|---|---|---|
reddit_search.py | 帖子和讨论搜索 | 无需 | |
twitter_search.py | Twitter/X | 推文搜索 | 需 TIKHUB_TOKEN |
youtube_search.py | YouTube | 视频搜索 | 需 YOUTUBE_API_KEY |
依赖
首次运行或脚本提示缺库时,使用本技能的依赖清单安装到当前 Python 环境:
python3 -m pip install -r requirements.txt
不要在脚本内部自动安装依赖。若安装失败、网络不可用或包不可用,停止使用对应脚本并改用网页搜索,说明缺少依赖。
参数说明
reddit_search.py
python3 scripts/reddit_search.py <query> [选项]
| 参数 | 说明 | 默认值 |
|---|---|---|
query | 搜索关键词(必填) | — |
--limit, -n | 返回结果数量 | 10 |
--subreddit, -r | 限定子版块(如 python, machinelearning) | — |
--sort | 排序方式:relevance, hot, top, new, comments | relevance |
--time, -t | 时间范围:hour, day, week, month, year, all | all |
python3 scripts/reddit_search.py "machine learning projects" --limit 5
python3 scripts/reddit_search.py "async python" --subreddit python --sort top --time month --limit 5
twitter_search.py
python3 scripts/twitter_search.py <query> [选项]
| 参数 | 说明 | 默认值 |
|---|---|---|
query | 搜索关键词(必填) | — |
--limit, -n | 返回结果数量 | 10 |
--token | TikHub Token(也可通过 TIKHUB_TOKEN 环境变量设置,必填) | — |
python3 scripts/twitter_search.py "AI agents" --limit 10
python3 scripts/twitter_search.py "LLM" --token your_tikhub_token --limit 5
youtube_search.py
python3 scripts/youtube_search.py <query> [选项]
| 参数 | 说明 | 默认值 |
|---|---|---|
query | 搜索关键词(必填) | — |
--limit, -n | 返回结果数量 | 10 |
--api-key | YouTube API 密钥(也可通过 YOUTUBE_API_KEY 环境变量设置,必填) | — |
--order | 排序方式:relevance, date, viewCount, rating | relevance |
python3 scripts/youtube_search.py "transformer explained" --limit 5
python3 scripts/youtube_search.py "python tutorial" --order viewCount --limit 10
输出格式
标准 JSON:{"success": true, "query": "...", "provider": "reddit|twitter|youtube", "items": [...], "error": null}
评论
支持 Markdown