SuperAPI AI 工具集

sn-search-social-en

写作与研究

查看项目

更新于 10-16 03:11

技能介绍

用途:搜索三个英文社交平台内容——Reddit 帖子与讨论、Twitter/X 推文、YouTube 视频。仓库为 opensensenova/sensenova-skills 下的 sn-search-social-en 技能。

主要能力与脚本:reddit_search.py(Reddit 帖子/讨论搜索,无需 API 密钥);twitter_search.py(推文搜索,需 TIKHUB_TOKEN);youtube_search.py(视频搜索,需 YOUTUBE_API_KEY)。

依赖安装:首次运行或提示缺库时执行 python3 -m pip install -r requirements.txt 脚本内部不自动安装依赖。安装失败、网络不可用或包不可用时,应停止使用对应脚本并改用网页搜索,并说明缺少依赖。

用法示例: 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 python3 scripts/twitter_search.py "AI agents" --limit 10 python3 scripts/youtube_search.py "transformer explained" --limit 5

常用参数:三者均需必填关键词 query,--limit/-n 默认 10。Reddit 支持 --subreddit/-r、--sort(relevance、hot、top、new、comments,默认 relevance)、--time(hour、day、week、month、year、all,默认 all)。Twitter 支持 --token(或 TIKHUB_TOKEN)。YouTube 支持 --api-key(或 YOUTUBE_API_KEY)、--order(relevance、date、viewCount、rating,默认 relevance)。

输出格式为标准 JSON:{"success": true, "query": "...", "provider": "reddit|twitter|youtube", "items": [...], "error": null}。

凭证与限制:API key、token 与 cookie 建议统一写在仓库根目录 .env(参考 .env.example),由 runtime 或用户在执行前加载为同名环境变量;脚本只从环境变量或显式 CLI 参数读取凭据,不要把真实密钥写入技能载荷、报告、日志或提交。Reddit 无需密钥,Twitter/X 与 YouTube 分别需要对应令牌或密钥。关于价格、收费、速率限制等,资料暂未提供。