sn-search-social-media

1# sn-search-social-media - 社区/社媒/新闻热点搜索
2 
3## 凭证配置
4 
5API key、token 与 cookie 统一建议写在仓库根目录 `.env`（参考 `.env.example`），并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证；不要把真实密钥写入 skill payload、报告、日志或提交。
6 
7本技能给 agent 用于抓取公开热点信号。只使用免费、免注册、免 API key、非加密货币的数据源；不要要求用户提供 token、cookie、API key，也不要使用商业收费接口。
8 
9## 硬性规则
10 
11- 禁止处理加密货币、虚拟货币、区块链、Web3、NFT、DeFi、交易所，以及加密货币语境下的挖矿/钱包等查询。
12- 如果用户请求加密货币相关热点，直接说明本技能不覆盖该主题，不要运行脚本。
13- 不使用 GitHub code search、GitHub GraphQL、Stack Exchange key、BigQuery、YouTube API、Twitter/X API、TikHub、Reddit OAuth 或任何需要注册 key/token/cookie 的方式。
14- 不使用无法访问、要求登录、要求付费或只有商业计划的资源；遇到新增资源，先确认能访问且符合以上限制。
15- API 脚本和 browser-use 没有优先级，可在同一任务中混合使用。
16- 百度指数、微博热搜/微指数只用公开网页可见内容；不要进入或引导使用付费商业功能。
17- 脚本返回标准 JSON；引用 `items[].url` 或 browser-use 打开的页面链接作为证据。
18 
19## 依赖
20 
21首次运行或脚本提示缺库时，使用本技能的依赖清单安装到当前 Python 环境：
22 
23```bash
24python3 -m pip install -r requirements.txt
25```
26 
27不要在脚本内部自动安装依赖。若安装失败、网络不可用或包不可用，停止使用对应脚本并改用 browser-use/公开网页搜索，说明缺少依赖。
28 
29## 资源选择
30 
31| 场景 | API 脚本 | browser-use 入口 | 说明 |
32| --- | --- | --- | --- |
33| 百科页面关注度、公众注意力辅助指标 | `scripts/wikimedia_pageviews.py` | `https://doc.wikimedia.org/generated-data-platform/aqs/analytics-api/` | Wikimedia Pageviews 需要 User-Agent |
34| 开源项目热度、工程活动、开发者生态 | `scripts/github_public_search.py` | `https://github.com/search` | 只搜公共仓库和 Issue；不搜 code |
35| 技术问题热度、开发者需求 | `scripts/stackexchange_search.py` | `https://stackexchange.com/search` | 默认 Stack Overflow，可指定 `--site` |
36| 创业、科技社区讨论热榜 | `scripts/hackernews_hotspots.py` | `https://news.ycombinator.com/` | 官方 API 不支持服务端搜索，脚本本地过滤 |
37…