last30days-cn · diff
v3.2.0-cn to v4.0.0-cn
97 added, 86 removed. Audit A to A.
---
name: last30days-cn
- version: "3.2.0-cn"
- description: "Chinese-platform last-30-days research skill covering Weibo, Xiaohongshu, Bilibili, Zhihu, Douyin, WeChat, Baidu, and Toutiao. Includes Markdown, JSON, compact context, and Guizang-inspired Swiss/IKB HTML report output."
- argument-hint: 'last30 AI 编程助手, last30 最近 30 天中文平台舆情, last30 具身智能 --html'
+ 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: "CN"
+ emoji: "📰"
requires:
optionalEnv:
- - WEIBO_ACCESS_TOKEN
- - SCRAPECREATORS_API_KEY
+ - WEIBO_COOKIE
- ZHIHU_COOKIE
+ - BILIBILI_COOKIE
- TIKHUB_API_KEY
- - DOUYIN_API_KEY
- WECHAT_API_KEY
- BAIDU_API_KEY
- - BAIDU_SECRET_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
- - trends
- html-report
---
# last30days-cn
- You are a Chinese-platform research assistant. Use this skill when the user asks for recent Chinese internet discussion, trend research, public-source evidence, or "last 30 days" coverage across Weibo, Xiaohongshu, Bilibili, Zhihu, Douyin, WeChat public accounts, Baidu, and Toutiao.
+ 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
+ ## Core rule
- Always ground claims in returned results. Do not invent sources, links, engagement numbers, dates, or platform sentiment. If coverage is sparse, say so clearly.
+ 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.
- ## Run
+ ## 1. Pick the mode
- Use the skill-local scripts directory:
+ | The user asks… | Run |
+ |---|---|
+ | About a topic / product / person / event | Topic research (section 2) |
+ | "今天/现在有什么热点", "热搜", "全网热榜", "trending" | Hot board: `--hot` (section 3) |
+ | Hot topics about one theme ("今天 AI 圈有什么热点") | `--hot "<关键词>"` |
+ | Overseas opinion too (Reddit / HN / GitHub / X / YouTube) | Add `--global --global-query "<English keywords>"` (section 4) |
+ | Something is broken / which platforms work | `--diagnose` (section 6) |
+ `{{SKILL_DIR}}` is this skill's directory. Use `python3` (or `python` on Windows).
+
+ ## 2. Topic research
+
```bash
python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --emit compact
```
- Useful variants:
+ Variants:
```bash
- python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --quick --emit compact
- python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --deep --emit md
- python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --emit html-path
- python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --search weibo,bilibili,zhihu --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}}" --refresh --emit compact
- python {{SKILL_DIR}}/scripts/last30days.py "{{USER_TOPIC}}" --no-cache --emit compact
- python {{SKILL_DIR}}/scripts/last30days.py --diagnose
- python {{SKILL_DIR}}/scripts/last30days.py --diagnose --emit json
- python {{SKILL_DIR}}/scripts/last30days.py setup
+ 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
```
- `--as-of YYYY-MM-DD` 以指定日期为终点回溯 N 天（历史回溯）；`--refresh` 忽略缓存并刷新结果；`--no-cache` 跳过缓存读写；`--cache-ttl HOURS` 控制缓存有效期。未指定 `--search` 时回退到环境变量 `LAST30DAYS_DEFAULT_SEARCH`，`EXCLUDE_SOURCES` 可排除指定源。输出中若多个平台讨论同一事件，会先给出「跨平台聚合热点」。
-
- ## 输出契约
-
- - Preserve the first engine badge line exactly, e.g. `🌐 last30days-cn v... · 数据截至 ...`; if it ends with `· 缓存`, mention that the evidence is cached.
- - Do not invent a new title before the badge and do not add a final `Sources:` block. Cite sources inline with platform names and URLs from the returned evidence.
- - Do not invent source availability, engagement numbers, dates, or cross-platform sentiment. If a source is unavailable or sparse, say that directly.
- - Treat `--diagnose` text as human-readable setup guidance; use `--diagnose --emit json` only when machine-readable status is needed.
-
- ## Output Modes
-
- - `compact`: concise Markdown evidence for the agent to synthesize.
- - `md`: full Markdown report.
- - `html`: complete standalone HTML report.
- - `html-path`: path to the generated `report.html`.
- - `json`: structured report data.
- - `context`: reusable context snippet.
- - `path`: path to `last30days.context.md`.
+ - 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.
- The HTML report uses a Swiss/IKB visual system inspired by `op7418/guizang-ppt-skill`. It is intended for browser viewing, archiving, and printing, not for interactive PPT generation.
+ ## 3. Hot board (全网热榜)
- ## 查询类型路由提示
+ ```bash
+ 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
+ ```
- - Breaking news, hot debates, or public sentiment: prioritize Weibo and Toutiao, with Baidu for cross-checking.
- - Tutorials, workflows, demos, or creator tools: prioritize Bilibili, Xiaohongshu, Zhihu, and WeChat.
- - Product reputation or recommendation questions: compare Xiaohongshu, Zhihu, Bilibili, and Weibo rather than relying on one platform.
- - When the topic is broad or ambiguous, run the default source set and synthesize only claims supported by returned evidence.
+ 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.
- ## Configuration
+ 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 "<话题>"`.
- Most sources can be tried with no configuration. Optional credentials improve stability:
+ ## 4. Overseas sources (opt-in)
- ```ini
- WEIBO_ACCESS_TOKEN=
- SCRAPECREATORS_API_KEY=
- ZHIHU_COOKIE=
- TIKHUB_API_KEY=
- DOUYIN_API_KEY=
- WECHAT_API_KEY=
- BAIDU_API_KEY=
- BAIDU_SECRET_KEY=
+ ```bash
+ 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
```
- Config file:
+ - 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`.
- ```text
- ~/.config/last30days-cn/.env
- ```
+ ## 5. 输出契约 (output contract)
- Optional crawler mode:
+ - 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".
- ```bash
- python -m pip install playwright
- python -m playwright install chromium
- ```
+ ## 6. Login-gated platforms and diagnostics
- For older macOS systems whose Playwright-managed browser cannot start, use a compatible system browser instead:
+ 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:
```bash
- export LAST30DAYS_BROWSER_PATH="/Applications/Chromium.app/Contents/MacOS/Chromium"
- # or: export LAST30DAYS_BROWSER_CHANNEL=chrome
- python {{SKILL_DIR}}/scripts/last30days.py --diagnose
+ 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
```
- Set `LAST30DAYS_DISABLE_BROWSER=1` to force browserless public API/search fallbacks. The `--diagnose` output reports the selected browser mode and path.
+ - `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.
- First-time setup helper:
+ ## 7. Synthesis guidance
- ```bash
- python {{SKILL_DIR}}/scripts/last30days.py setup
- ```
+ 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.
- ## Synthesis Guidance
+ ## Configuration
- When presenting the final answer:
+ Everything is optional. Settings go in `~/.config/last30days-cn/.env` (or `.claude/last30days-cn.env` in a project):
- 1. State the date range and the active sources.
- 2. Separate confirmed findings from weak or sparse signals.
- 3. Cite platform and URL for important claims.
- 4. Compare platform differences when multiple sources discuss the same topic.
- 5. Mention unavailable or failed sources if that affects confidence.
- 6. Keep the final answer in Chinese unless the user requests otherwise.
+ ```ini
+ 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. Use low frequency, respect platform terms and robots.txt, and avoid large-scale scraping, personal data collection, commercial collection services, or any illegal use.
+ 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.