SuperAPI AI Directory
Partner中文AI newsFavorites
Skillslast30days-cn

last30days-cn

Writing & research

View repository

Updated 10-15 23:30

About this skill

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, "last 30 days" coverage, or what is trending right now (trending searches / hot lists / what's hot today).

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

The user asks… Run
About a topic / product / person / event Topic research (section 2)
"What's hot today/right now", "trending searches", "all-network hot lists", "trending" Hot board: --hot (section 3)
Hot topics about one theme ("What's hot in the AI world today") --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

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).
  • The 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 ("What does everyone think…") 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 (all-network hot lists)

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 Weibo trending, Baidu trending, Douyin hot list, Toutiao hot list, Bilibili trending searches and Zhihu hot list in parallel. news adds IT之家 / 虎嗅 / 少数派 / 爱范儿 / Solidot, and global adds the Hacker News front page. "Cross-platform hot topics" lists events that are on several boards at once.

When you present it: lead with cross-platform hot topics, 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 (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 "hot list/public search fallback" 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, Weibo, Xiaohongshu, Zhihu and Douyin 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 aggregated hot topics (cross-platform clusters) when present: the same event seen on several platforms is the strongest signal.
  3. Compare platform cultures where relevant: Xiaohongshu experience posts vs Zhihu analysis vs Weibo reactions vs Bilibili 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.