sn-search-social-cn

凭证配置

API key、token 与 cookie 统一建议写在仓库根目录 .env（参考 .env.example），并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证；不要把真实密钥写入 skill payload、报告、日志或提交。

搜索 B站、知乎、小红书、微博、抖音五个中文社交平台。

稳定性说明

中文社交平台没有稳定的公开搜索 API，所有脚本依赖内部 API 或第三方库，可能因平台更新而失效。

脚本	平台	稳定性	认证方式
bilibili_search.py	B站	较高	无需（可选 cookie 提高质量）
zhihu_search.py	知乎	中等	需 ZHIHU_COOKIE
xiaohongshu_search.py	小红书	中等	需 XHS_COOKIE
weibo_search.py	微博	中等	需 WEIBO_COOKIE
douyin_search.py	抖音	较低	需 DOUYIN_COOKIE

依赖

首次运行或脚本提示缺库时，使用本技能的依赖清单安装到当前 Python 环境：

python3 -m pip install -r requirements.txt

不要在脚本内部自动安装依赖。若安装失败、网络不可用或包不可用，停止使用对应脚本并改用 browser-use 搜索免费可见网页，说明缺少依赖。

Cookie 获取方式

1. 在浏览器中登录对应平台
2. 打开开发者工具（F12）→ Network 标签
3. 刷新页面，在请求头中找到 Cookie 字段
4. 将完整 cookie 字符串设置为对应环境变量

参数说明

bilibili_search.py

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

参数	说明	默认值
query	搜索关键词（必填）	—
--limit, -n	返回结果数量	10
--cookie	B站 Cookie（也可通过 BILIBILI_COOKIE 环境变量设置，可选，提高结果质量）	—
--order	排序：空=综合, totalrank=最佳匹配, click=播放, pubdate=最新, dm=弹幕, stow=收藏	综合

python3 scripts/bilibili_search.py "机器学习教程" --limit 5
python3 scripts/bilibili_search.py "Python" --order click --limit 10

zhihu_search.py

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

参数	说明	默认值
query	搜索关键词（必填）	—
--limit, -n	返回结果数量	10
--cookie	知乎 Cookie（也可通过 ZHIHU_COOKIE 环境变量设置，必填）	—
--type	搜索类型：general, topic, people, zvideo	general

ZHIHU_COOKIE="..." python3 scripts/zhihu_search.py "Python 异步编程" --limit 5
python3 scripts/zhihu_search.py "大模型" --cookie "..." --type topic --limit 5

xiaohongshu_search.py

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

参数	说明	默认值
query	搜索关键词（必填）	—
--limit, -n	返回结果数量	10
--cookie	小红书 Cookie（也可通过 XHS_COOKIE 环境变量设置，必填）	—
--sort	排序方式：general=综合, hot=热度, new=最新	general

XHS_COOKIE="..." python3 scripts/xiaohongshu_search.py "咖啡推荐" --limit 5
python3 scripts/xiaohongshu_search.py "美食" --cookie "..." --sort hot --limit 10

weibo_search.py

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

参数	说明	默认值
query	搜索关键词（必填）	—
--limit, -n	返回结果数量	10
--cookie	微博 Cookie（也可通过 WEIBO_COOKIE 环境变量设置，必填）	—
--page	页码	1

WEIBO_COOKIE="..." python3 scripts/weibo_search.py "AI 新闻" --limit 5
python3 scripts/weibo_search.py "热搜" --cookie "..." --page 2 --limit 10

douyin_search.py

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

参数	说明	默认值
query	搜索关键词（必填）	—
--limit, -n	返回结果数量	10
--cookie	抖音 Cookie（也可通过 DOUYIN_COOKIE 环境变量设置，必填）	—

DOUYIN_COOKIE="..." python3 scripts/douyin_search.py "编程教程" --limit 5

输出格式

标准 JSON：{"success": true, "query": "...", "provider": "bilibili|zhihu|xiaohongshu|weibo|douyin", "items": [...], "error": null}