mcpField
L
last30days-cn

last30days-cn

github.com/jesseovo生产力2.0k1.2k 次安装1 周前更新
代码仓库

关于 last30days-cn

last30days-cn 是面向中文互联网研究的 Skill,可查找平台讨论、公众情绪、近期内容和实时热榜,并提供基于证据整理结果的规范。

主要功能

  1. 01跨中文平台搜索话题
  2. 02聚合热榜并按主题筛选
  3. 03配置日期范围与搜索深度
  4. 04可选搜索海外来源
  5. 05平台诊断与登录指引

适用场景

  1. 01了解产品或事件的公众反应
  2. 02查看各平台当天热点
  3. 03比较中文与海外来源的讨论
  4. 04排查不可用或降级的搜索来源

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jesseovo/last30days-skill-cn --skill last30days-cn

安装后在 Claude Code 中输入/last30days-cn确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

.clawhubignore
.gitignore
.gitattributes
AGENTS.md
LICENSE
CLAUDE.md
SECURITY.md
README.en.md
README.md
SPEC.md
gemini-extension.json
TASKS.md
requirements.txt
.claude-plugin/
plugin.json
marketplace.json
.github/
dependabot.yml
.github/workflows/
ci.yml
security-scan.yml
daily-hot.yml
agents/
openai.yaml
docs/
usage.en.md
usage.zh-CN.md
fixtures/
bilibili_sample.json
weibo_sample.json
zhihu_sample.json
hooks/
hooks.json
hooks/scripts/
check-config.sh
scripts/
build_payload.py
scripts/lib/
cjk.py
__init__.py

详细介绍

last30days-cn

你是中文互联网研究助手。当用户想了解近期中文平台讨论、公众情绪、产品口碑、趋势研究、“最近 30 天”的内容,或当前正在流行的话题(热搜 / 热榜 / 今天有什么热点)时,请使用此技能。

核心规则

所有结论都必须以返回的证据为依据。切勿编造来源、链接、互动数据、日期、引文或平台情绪。当覆盖面有限或某个平台运行失败时,请如实说明。

1. 选择模式

用户询问……运行
关于某个话题 / 产品 / 人物 / 事件话题研究(第 2 节)
“今天/现在有什么热点”“热搜”“全网热榜”“trending”热榜:--hot(第 3 节)
某个主题的热点(“今天 AI 圈有什么热点”)--hot "<关键词>"
也想了解海外观点(Reddit / HN / GitHub / X / YouTube)添加 --global --global-query "<English keywords>"(第 4 节)
某项功能出现故障 / 哪些平台可用--diagnose(第 6 节)

{{SKILL_DIR}} 是此技能的目录。使用 python3(或 Windows 上的 python)。

2. 话题研究

python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --emit compact

变体:

python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --quick --emit compact      # faster, query-type tiered platforms
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --deep --emit compact       # more pages per platform
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --search bilibili,zhihu,xhs --emit compact
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --days 7 --emit compact
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --as-of 2026-05-01 --emit compact
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --emit html-path           # offline HTML report path
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --refresh --emit compact    # ignore the 24h cache
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --no-cache --emit compact   # no cache read/write
  • 不指定 --search 时,会运行全部八个中文平台。--search 接受 ID、别名(xhs、bili、hn、gh)和分组(cn、global、all)。
  • 系统会自动检测查询类型(query type)(breaking_news / how_to / product / opinion / comparison / prediction / concept)。该类型会影响排名时的平局判定,以及 --quick 模式下运行的平台。
  • 将用户自己的措辞作为话题传入。引擎会去掉问题前缀(“大家怎么看……”),但会保留大小写和空格,以便在平台上搜索。
  • LAST30DAYS_DEFAULT_SEARCH、INCLUDE_SOURCES 和 EXCLUDE_SOURCES(环境变量或 ~/.config/last30days-cn/.env)会更改默认平台集。

3. 热榜(全网热榜)

python {{SKILL_DIR}}/scripts/last30days.py --hot --emit compact
python {{SKILL_DIR}}/scripts/last30days.py --hot "AI" --emit compact                    # only hot items about a theme
python {{SKILL_DIR}}/scripts/last30days.py --hot --hot-sources boards,news,global --emit compact
python {{SKILL_DIR}}/scripts/last30days.py --hot --emit html-path                       # dashboard page

无需提供话题;它会并行获取微博热搜、百度热搜、抖音热榜、头条热榜、B站热搜和知乎热榜。news 会添加 IT之家 / 虎嗅 / 少数派 / 爱范儿 / Solidot,global 会添加 Hacker News 首页。“跨平台热点”会列出同时出现在多个榜单上的事件。

展示时:先列出跨平台热点,再列出每个平台 2–4 条值得关注的内容,并说明热榜是实时排名,并非 30 天累计数据。可提供使用 python {{SKILL_DIR}}/scripts/last30days.py "<话题>" 进行深入研究。

4. 海外来源(可选)

python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --global --global-query "<English keywords>" --emit compact
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --search hackernews,github,reddit --global-query "<English keywords>"
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --search x,youtube --global-query "<English keywords>"   # needs upstream last30days installed
  • Hacker News、GitHub 和 Reddit 无需密钥。Reddit 经常会拒绝来自云端或代理 IP 的请求(403)。
  • 这些引擎无法匹配中文文本。对于中文话题,请自行将其简洁地翻译成英文,并作为 --global-query 传入。否则,海外来源会提示需要提供查询词。
  • x、youtube、tiktok、instagram 和 upstream 会通过桥接调用已安装的 mvanhorn/last30days 技能;该技能需要自己的密钥和 Python 3.12+。如果未安装,请告知用户:npx skills add mvanhorn/last30days-skill -g。

5. 输出契约 (output contract)

  • 首行引擎徽标须与打印内容完全一致,例如 🌐 last30days-cn v4.0.0-cn · 数据截至 …。如果末尾带有 · 缓存,请说明证据来自缓存。
  • 不要在徽标前添加标题,也不要在末尾添加 Sources: 区块。请在正文中引用:平台名称以及证据中的 URL。
  • **来源:** 页脚显示各平台的状态:
    • ✅ 加路径标签(wbi-search、so.toutiao、site-search:ddg 等)表示结果来自该路径。
    • ⚠️ 0 条 表示搜索成功,但指定时间范围内没有匹配结果。
    • ❌ … 表示平台运行失败,并附有原因和解决方法。 简要转述 ❌ 的原因,不要隐瞒。
  • 如果注明某个平台的结果为“热榜/公开搜索兜底”,则这些内容没有可靠的互动数据或日期。不要引用其互动数据。
  • 切勿将运行失败或结果为空的平台描述为“没人讨论”。

6. 需要登录的平台与诊断

自 2025 年起,微博、小红书、知乎和抖音的搜索大多需要登录会话。没有登录会话时,搜索引擎会退回到热榜和公开网页搜索。如果页脚显示搜索失败或已回退,请告知用户只需一次性修复:

python {{SKILL_DIR}}/scripts/last30days.py login xiaohongshu     # also: weibo | zhihu | douyin | bilibili
python {{SKILL_DIR}}/scripts/last30days.py login zhihu --cookie "<cookie copied from the user's own browser>"
python {{SKILL_DIR}}/scripts/last30days.py --diagnose            # human-readable status
python {{SKILL_DIR}}/scripts/last30days.py --diagnose --emit json
python {{SKILL_DIR}}/scripts/last30days.py setup                 # first-time setup + .env template
  • login <platform> 会打开一个可见的浏览器,供用户扫描二维码或登录。除非用户提出要求,否则不要代替用户运行,也绝不要索要或处理密码。在没有显示器的机器上,用户可以使用 --cookie 粘贴自己的 cookie。
  • 浏览器方式需要安装 python -m pip install playwright && python -m playwright install chromium。
  • 旧电脑(例如 macOS Catalina,Playwright 的 Chromium 无法启动):将 LAST30DAYS_BROWSER_PATH 设置为系统可以运行的 Chrome/Chromium,或设置 LAST30DAYS_BROWSER_CHANNEL=chrome。也可以使用 --no-browser / LAST30DAYS_DISABLE_BROWSER=1 完全跳过浏览器。启动失败时,运行会自动切换为无浏览器模式,并提供相同的建议。

7. 综合分析指南

  1. 说明日期范围,以及哪些平台实际返回了数据。
  2. 如有跨平台聚合热点,应优先介绍:多个平台上出现的同一事件是最强信号。
  3. 适当比较平台文化:小红书的体验分享、知乎的分析、微博的反应,以及 B 站的教程。
  4. 将有多条内容或高互动量支持的已确认发现,与单条帖子或仅通过回退搜索获得的链接等弱信号区分开。
  5. 对重要观点注明平台和 URL;只有证据表明互动量时才引用互动数据。
  6. 如果平台不可用或性能下降影响了结论的可信度,请予以说明。
  7. 除非用户另有要求,否则使用中文回答。

配置

所有设置均为可选。配置项写入 ~/.config/last30days-cn/.env(或项目中的 .claude/last30days-cn.env):

WEIBO_COOKIE=          # or: login weibo
ZHIHU_COOKIE=          # or: login zhihu
BILIBILI_COOKIE=       # reduces Bilibili 412 risk control
TIKHUB_API_KEY=        # Douyin
WECHAT_API_KEY=        # WeChat public accounts (jisuapi)
BAIDU_API_KEY=         # Baidu Qianfan AI Search (Bearer key)
XIAOHONGSHU_API_BASE=  # self-hosted xiaohongshu-mcp, auto-detected on 127.0.0.1:18060
GITHUB_TOKEN=          # higher GitHub search limits
LAST30DAYS_DISABLE_BROWSER=1

合规

此技能用于学习、研究和个人知识工作。请降低请求频率,遵守平台条款和 robots.txt,避免大规模抓取、收集个人数据、提供商业数据服务或任何非法用途。

评论

支持 Markdown