name: last30days-cn version: "4.0.0-cn" description: "Research what Chinese internet users actually said in the last 30 days across Weibo, Xiaohongshu (RED), Bilibili, Zhihu, Douyin, WeChat public accounts, Baidu and Toutiao: engagement-weighted ranking, cross-platform clustering, cited Markdown/JSON/HTML reports. Also shows today's cross-platform hot-search board (全网热榜, --hot) and can add Hacker News / GitHub / Reddit or an installed upstream last30days for X/YouTube/TikTok." argument-hint: 'last30 AI 编程助手 | last30 今天全网热点 | last30 具身智能 --deep | last30 Claude Code 评测 --global' allowed-tools: Bash, Read, Write, WebSearch author: Jesse license: MIT user-invocable: true metadata: openclaw: emoji: "📰" requires: optionalEnv: - WEIBO_COOKIE - ZHIHU_COOKIE - BILIBILI_COOKIE - TIKHUB_API_KEY - WECHAT_API_KEY - BAIDU_API_KEY - WEIBO_ACCESS_TOKEN - XIAOHONGSHU_API_BASE - GITHUB_TOKEN bins: - python3 files: - "scripts/*" tags: - research - deep-research - chinese-platforms - trending - hot-search - weibo - xiaohongshu - bilibili - zhihu - douyin - wechat - baidu - toutiao - html-report

last30days-cn

You are a Chinese-internet research assistant. Use this skill when the user wants recent Chinese-platform discussion, public sentiment, product reputation, trend research, "最近 30 天" coverage, or what is trending right now (热搜 / 热榜 / 今天有什么热点).

Core rule

Ground every claim in the returned evidence. Never invent sources, links, engagement numbers, dates, quotes or platform sentiment. When coverage is thin or a platform failed, say so plainly.

1. Pick the mode

{{SKILL_DIR}} is this skill's directory. Use python3 (or python on Windows).

2. Topic research

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

Variants:

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

• With no --search, all eight Chinese platforms run. --search accepts ids, aliases (xhs, bili, hn, gh) and groups (cn, global, all).
• 查询类型 (query type) is detected automatically (breaking_news / how_to / product / opinion / comparison / prediction / concept). It changes ranking tie-breaks, and in --quick mode which platforms run.
• Pass the user's own wording as the topic. The engine strips question prefixes ("大家怎么看…") but keeps casing and spacing for platform search.
• LAST30DAYS_DEFAULT_SEARCH, INCLUDE_SOURCES and EXCLUDE_SOURCES (env or ~/.config/last30days-cn/.env) change the default platform set.

3. Hot board (全网热榜)

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

It needs no topic and fetches 微博热搜, 百度热搜, 抖音热榜, 头条热榜, B站热搜 and 知乎热榜 in parallel. news adds IT之家 / 虎嗅 / 少数派 / 爱范儿 / Solidot, and global adds the Hacker News front page. "跨平台热点" lists events that are on several boards at once.

When you present it: lead with 跨平台热点, then 2–4 notable items per platform, and say that hot lists are real-time rankings, not 30-day totals. Offer a deep-dive with python {{SKILL_DIR}}/scripts/last30days.py "<话题>".

4. Overseas sources (opt-in)

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 and Reddit need no keys. Reddit often returns 403 from cloud or proxy IPs.
• These engines don't match Chinese text. For a Chinese topic, translate it into concise English yourself and pass it as --global-query. Otherwise the overseas sources report that a query is needed.
• x, youtube, tiktok, instagram and upstream go through the bridge to an installed mvanhorn/last30days skill, which needs its own keys and Python 3.12+. If it isn't installed, tell the user: npx skills add mvanhorn/last30days-skill -g.

5. 输出契约 (output contract)

• Keep the first engine badge line exactly as printed, e.g. 🌐 last30days-cn v4.0.0-cn · 数据截至 …. If it ends with · 缓存, say the evidence came from cache.
• Don't add a title before the badge and don't add a trailing Sources: block. Cite inline: platform name plus the URL from the evidence.
• The **来源:** footer shows each platform's status:
  • ✅ with a path label (wbi-search, so.toutiao, site-search:ddg, …) means results came from that path.
  • ⚠️ 0 条 means the search worked but nothing matched the window.
  • ❌ … means the platform failed, with the reason and a fix. Relay ❌ reasons briefly; don't hide them.
• A note that a platform's results are "热榜/公开搜索兜底" means those items have no reliable engagement numbers or dates. Don't quote engagement for them.
• Never present a failed or empty platform as "nobody is talking about it".

6. Login-gated platforms and diagnostics

Since 2025, 微博, 小红书, 知乎 and 抖音 search mostly require a logged-in session. Without one, the engine falls back to hot lists and public web search. When the footer shows they failed or fell back, tell the user the one-time fix:

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> opens a visible browser for the user to scan a QR code or sign in. Don't run it on their behalf unless they ask, and never ask for or handle passwords. On machines without a display, the user can paste their own cookie with --cookie.
• The browser path needs python -m pip install playwright && python -m playwright install chromium.
• Old computers (e.g. macOS Catalina, where Playwright's Chromium won't start): set LAST30DAYS_BROWSER_PATH to a Chrome/Chromium the system can run, or LAST30DAYS_BROWSER_CHANNEL=chrome. You can also skip the browser entirely with --no-browser / LAST30DAYS_DISABLE_BROWSER=1. A failed launch switches the run to browserless mode automatically, with that same advice.

7. Synthesis guidance

1. State the date range and which platforms actually returned data.
2. Lead with 跨平台聚合热点 (cross-platform clusters) when present: the same event seen on several platforms is the strongest signal.
3. Compare platform cultures where relevant: 小红书 experience posts vs 知乎 analysis vs 微博 reactions vs B站 tutorials.
4. Separate confirmed findings, backed by several items or high engagement, from weak signals such as a single post or fallback-only links.
5. Cite platform plus URL for important claims, and quote engagement only when the evidence shows it.
6. Mention unavailable or degraded platforms when that limits confidence.
7. Answer in Chinese unless the user asks otherwise.

Configuration

Everything is optional. Settings go in ~/.config/last30days-cn/.env (or .claude/last30days-cn.env in a project):

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

Compliance

This skill is for learning, research and personal knowledge work. Keep request frequency low, respect platform terms and robots.txt, and avoid large-scale scraping, personal-data collection, commercial data services or any illegal use.

last30days-cn

中文互联网近 30 天研究引擎。 让 AI Agent 去微博、小红书、B站、知乎、抖音、微信公众号、百度、今日头条看看最近大家到底在说什么，按互动和时效排序、跨平台归并，写成每条结论都有出处的研究报告。也可以一条命令查看全网热榜。

npx skills add Jesseovo/last30days-skill-cn -g

装好后直接对你的 Agent 说：

用 last30days 研究一下「新能源汽车价格战」最近 30 天的讨论

今天全网有什么热点？

它能做什么

• 主题研究：8 个平台并行检索，按相关性、时效、互动打分；同一事件在多个平台出现时归并为「跨平台热点」。输出有四种：给 Agent 的精简证据、完整 Markdown、JSON、可离线打开的 HTML 报告。
• 全网热榜：不需要主题，汇总微博、百度、抖音、头条、B站、知乎热榜并合并跨平台热点；可加入科技资讯 RSS 和 Hacker News，还能每天自动发布成热点网页。
• 如实交代覆盖情况：报告末尾逐平台列出拿到多少条、走了哪条数据路径；失败的平台写明原因和修复命令，不会把「没拿到数据」说成「没人讨论」。
• 登录态复用：需要登录的平台扫码一次即可长期使用；没有图形界面时可以导入 Cookie。
• 海外视角（可选）：Hacker News、GitHub、Reddit，以及通过上游 last30days 获取 X、YouTube、TikTok。
• 轻量：只依赖 Python 3.8+ 标准库，浏览器和分词都是可选增强，旧电脑也能用。

快速开始

作为 Agent 技能使用（Claude Code、Codex、Cursor、Gemini CLI 等支持 Agent Skills 的工具）：

npx skills add Jesseovo/last30days-skill-cn -g

直接在命令行使用：

git clone https://github.com/Jesseovo/last30days-skill-cn.git
cd last30days-skill-cn
python scripts/last30days.py "AI编程助手"      # 研究一个主题
python scripts/last30days.py --hot              # 全网热榜
python scripts/last30days.py --diagnose         # 查看各平台是否可用、怎么修

可选增强：

python -m pip install jieba                                                  # 更准的中文分词
python -m pip install playwright && python -m playwright install chromium    # 登录态平台需要

# Claude Code 手动安装
git clone https://github.com/Jesseovo/last30days-skill-cn.git ~/.claude/skills/last30days-cn
# OpenClaw / ClawHub
git clone https://github.com/Jesseovo/last30days-skill-cn.git ~/.agents/skills/last30days-cn

• Cursor：克隆仓库后，把 SKILL.md 添加为项目技能。
• Gemini CLI：克隆后作为扩展加载（见 gemini-extension.json）。
• 其他 Agent：只要支持 Bash、Read、Write 就能用。

使用

研究一个主题

python scripts/last30days.py "AI编程助手"                       # 默认：8 个平台、最近 30 天
python scripts/last30days.py "AI编程助手" --emit html-path      # 生成 HTML 报告并输出路径
python scripts/last30days.py "AI编程助手" --deep                # 每个平台抓更多
python scripts/last30days.py "AI编程助手" --quick               # 只跑和问题类型最相关的平台
python scripts/last30days.py "AI编程助手" --search bili,zhihu,xhs
python scripts/last30days.py "AI编程助手" --days 7
python scripts/last30days.py "AI编程助手" --as-of 2026-05-01    # 回看某个历史时间窗

输出示例（格式示意）：

🌐 last30days-cn v4.0.0-cn · 数据截至 2026-10-03
## 研究结果: AI编程助手

### 🔗 跨平台聚合热点
- **某工具发布新版本** — 覆盖 B站、今日头条、微博（4 条）

### B站视频
**BL1** (得分:95) 某UP主 (2026-09-28) [1,446播放, 140收藏, 116点赞]
  2026 最新 Codex 完整教程
  https://www.bilibili.com/video/BV...

---
**来源:**
  ✅ B站: 18 条（路径: wbi-search×20）
  ✅ 今日头条: 6 条（原始 15 条，按时间窗/相关性保留）（路径: so.toutiao×15）
  ❌ 小红书: 小红书搜索需要登录态：运行 `python scripts/last30days.py login xiaohongshu` …

报告文件保存在 ~/.local/share/last30days/out/：report.md、report.json、report.html、last30days.context.md。

全网热榜

python scripts/last30days.py --hot                                   # 微博 / 百度 / 抖音 / 头条 / B站 / 知乎
python scripts/last30days.py --hot AI                                # 只看和某个主题有关的热点
python scripts/last30days.py --hot --hot-sources boards,news,global  # 加上科技资讯 RSS 与 Hacker News
python scripts/last30days.py --hot --emit html-path                  # 生成热榜网页

• 同一件事在不同平台的叫法往往不同（「中国男足获亚运铜牌」/「拿下点球大战！U23国足获亚运铜牌」），热榜会按关键词把它们合并成一条「跨平台热点」，按登上的平台数排序。
• 热榜网页带关键词筛选、深色模式和手机布局。
• 自定义资讯源：设置 LAST30DAYS_HOT_FEEDS="名称|RSS地址,名称|RSS地址"，例如自建 RSSHub 的 36 氪快讯或 X 列表。

每日热点网站

仓库自带 GitHub Actions 工作流 .github/workflows/daily-hot.yml，可以把热榜每天自动发布成一个网页。默认不运行，在你的仓库（或 fork）中启用：

1. Settings → Pages → Source 选择 GitHub Actions
2. Settings → Secrets and variables → Actions → Variables，新建 HOT_PAGES，值为 true
3. （可选）设置变量 HOT_SOURCES（默认 boards,news,global）、HOT_FEEDS（自定义 RSS）、HOT_TITLE（页面标题）
4. Actions → Daily Hot Board → Run workflow

之后每天北京时间 08:00、12:00、20:00 自动更新，地址为 https://<用户名>.github.io/<仓库名>/。

需要登录的平台

小红书、微博、知乎、抖音的搜索基本都要求登录。扫码登录一次即可（需要 Playwright）：

python scripts/last30days.py login xiaohongshu   # 也支持 weibo / zhihu / douyin / bilibili

• 登录态保存在 ~/.config/last30days-cn/browser_cookies/（仅当前用户可读），之后的检索会自动复用；过期后会提示重新登录。

• 服务器、SSH 等没有图形界面的环境，可以导入自己浏览器里复制的 Cookie：

  python scripts/last30days.py login zhihu --cookie "z_c0=...; _xsrf=..."
  

• 也可以在配置文件里填 WEIBO_COOKIE、ZHIHU_COOKIE、BILIBILI_COOKIE。

• 不登录也能用：这些平台会改用热榜匹配和公开搜索兜底，报告里会注明「只有公开链接，缺少互动数据」。

海外平台（可选）

python scripts/last30days.py "Claude Code 评测" --global                                # 加上 Hacker News / GitHub / Reddit
python scripts/last30days.py "AI编程助手" --global --global-query "AI coding assistant"  # 中文主题需提供英文关键词
python scripts/last30days.py "Claude Code" --search x,youtube                            # 通过上游 last30days 获取

• Hacker News、GitHub、Reddit 不需要 Key。GitHub 可配置 GITHUB_TOKEN 提高额度；Reddit 会拒绝部分云服务器 IP，遇到时会明确提示。
• X、YouTube、TikTok、Instagram 通过本机安装的上游 skill 获取（npx skills add mvanhorn/last30days-skill -g，需要 Python 3.12+）。
• 默认关闭；想长期开启可以在配置里写 INCLUDE_SOURCES=global。

旧电脑与无浏览器模式

• B站、头条、微信公众号、百度和全网热榜都不需要浏览器。

• 浏览器启动失败时，本次运行会自动切换到无浏览器模式，并提示修复方法，不会让每个平台各卡一遍。

• 新版 Chromium 在旧系统（如 macOS Catalina）上启动不了时，可以改用系统已经装好的浏览器：

  export LAST30DAYS_BROWSER_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
  python scripts/last30days.py --diagnose --probe-browser    # 真实启动一次，确认可用
  

• 完全不用浏览器：加 --no-browser，或在配置里写 LAST30DAYS_DISABLE_BROWSER=1。

• 机器性能一般时，设置 LAST30DAYS_BROWSER_CONCURRENCY=1 让浏览器一个一个开。

• 支持 Python 3.8（macOS Catalina 自带的 python3）。

平台与数据路径

「公开搜索」指通过搜索引擎查找该平台的公开页面，只能拿到链接和摘要，没有可靠的互动数据和精确日期。报告会把这类结果单独标出。

配置

所有配置都是可选的。运行 python scripts/last30days.py setup 会生成带注释的配置模板 ~/.config/last30days-cn/.env（项目级配置放在 .claude/last30days-cn.env）：

# 登录态（推荐用 login 命令扫码；没有图形界面时再手动填写）
WEIBO_COOKIE=
ZHIHU_COOKIE=
BILIBILI_COOKIE=

# API Key
TIKHUB_API_KEY=          # 抖音
WECHAT_API_KEY=          # 微信公众号（极速数据）
BAIDU_API_KEY=           # 百度千帆「AI 搜索」
WEIBO_ACCESS_TOKEN=      # 微博开放平台
XIAOHONGSHU_API_BASE=    # 自部署的 xiaohongshu-mcp，默认自动探测 127.0.0.1:18060
GITHUB_TOKEN=            # 海外 GitHub 源

# 运行开关
LAST30DAYS_DISABLE_BROWSER=1     # 不使用浏览器
LAST30DAYS_BROWSER_PATH=         # 指定本机浏览器
INCLUDE_SOURCES=global           # 默认附带海外源
EXCLUDE_SOURCES=douyin           # 默认排除某些平台
LAST30DAYS_HOT_FEEDS=            # 热榜自定义 RSS

优先级：命令行环境变量 > 项目级配置 > 全局配置。Windows（PowerShell）创建配置目录：New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\last30days-cn"。

命令参考

工作原理

1. 检索：各平台并行运行，每个平台有自己的超时，一个平台卡住不影响其他平台。每个平台按「API → 登录态 → 公开接口 → 公开搜索」逐级尝试。
2. 清洗：统一字段 → 过滤研究时间窗外的内容 → 同平台去重 → 去掉与主题无关的结果 → 同一作者最多保留 3 条。
3. 打分：综合分（0–100）= 相关性 45% + 时效 25% + 互动 30%。网页类来源（百度、公众号）只看相关性和时效。
4. 归并：比较不同平台的内容时先去掉主题词本身，再判断是否在说同一件事，避免仅因提到同一主题就被误判为同一事件。
5. 输出：精简证据给 Agent 归纳，同时写出完整报告文件。

各平台的互动指标：微博（转发 / 评论 / 点赞）、小红书（点赞 / 收藏 / 评论 / 分享）、B站（播放 / 弹幕 / 评论 / 点赞 / 收藏）、知乎（赞同 / 评论 / 收藏）、抖音（点赞 / 评论 / 分享 / 播放）、头条（阅读 / 评论 / 点赞）。

项目结构

last30days-skill-cn/
├── SKILL.md                 # Agent 读取的技能说明
├── scripts/
│   ├── last30days.py        # 命令行入口
│   └── lib/                 # 平台适配、检索流水线、热榜、渲染、诊断等
├── skills/last30days/       # 自动生成的可安装技能包（勿手动修改）
├── tests/                   # 回归测试（不联网）
└── .github/workflows/       # CI 与每日热榜发布

参与开发请先阅读 AGENTS.md，技术细节见 SPEC.md，版本变化见 release-notes.md。

⚠️ 免责声明

请务必仔细阅读以下内容。使用本项目即表示您同意以下所有条款。

1. 本项目仅供学习和研究目的，严禁用于商业用途。
2. 使用者必须遵守中华人民共和国相关法律法规，包括但不限于《网络安全法》《数据安全法》《个人信息保护法》《反不正当竞争法》。
3. 使用者必须遵守各平台的服务条款和 robots.txt 规定。
4. 禁止将本项目用于以下行为：
   • 大规模、高频率抓取平台数据
   • 收集、存储或传播他人个人信息
   • 破坏或干扰平台正常运营
   • 数据倒卖或任何商业牟利
   • 对外提供自动化数据采集服务
5. 本项目开发者不承担因使用本项目而产生的任何法律责任，使用者自行承担全部法律风险。
6. 如有侵权，请联系作者，将第一时间处理。

浏览器模式驱动真实浏览器、复用你本人登录的会话，由页面自己发出请求，不涉及逆向加密算法或破解安全机制。各平台接口随时可能变更，本项目不保证所有功能始终可用。请控制请求频率（建议每次搜索间隔 ≥ 5 秒）。

💡 爬虫违法违规的案例频发，请务必合法合规使用。参考：中国爬虫相关法律案例汇总

致谢

• mvanhorn/last30days-skill：原版项目，也是海外平台桥接的对象
• [NanmiCoder/MediaCrawler]