Autosearch xiaohongshu

Skill Attribution

install
source · Clone the upstream repo
git clone https://github.com/0xmariowu/Autosearch
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/0xmariowu/Autosearch "$T" && mkdir -p ~/.claude/skills && cp -r "$T/autosearch/skills/channels/xiaohongshu" ~/.claude/skills/0xmariowu-autosearch-xiaohongshu && rm -rf "$T"
manifest: autosearch/skills/channels/xiaohongshu/SKILL.md
source content

Skill Attribution

Source: self-written, plan

autosearch-0418-channels-and-skills.md
§ F002c.


name: xiaohongshu description: Chinese lifestyle + experience-sharing notes with strong product/beauty/travel/food coverage, via TikHub. version: 1 languages: [zh, mixed] methods:

  • id: via_signsrv impl: methods/via_signsrv.py requires: [env:AUTOSEARCH_SIGNSRV_URL, env:AUTOSEARCH_SERVICE_TOKEN, env:XHS_COOKIES] rate_limit: {per_min: 60, per_hour: 1000}
  • id: via_tikhub impl: methods/via_tikhub.py requires: [env:TIKHUB_API_KEY] rate_limit: {per_min: 60, per_hour: 1000} fallback_chain: [via_signsrv, via_tikhub] when_to_use: query_languages: [zh, mixed] query_types: [product-review, experience-report, lifestyle, consumer, travel] domain_hints: [consumer, beauty, food, travel, parenting] quality_hint: typical_yield: high chinese_native: true layer: leaf domains: [chinese-ugc] scenarios: [chinese-native, product-review, lifestyle] model_tier: Fast experience_digest: experience.md

Overview

Xiaohongshu is a Chinese lifestyle and consumer discovery platform centered on short notes about products, beauty, food, travel, and day-to-day experience sharing. It is useful when the query needs Chinese-native recommendation content, purchase impressions, or experiential evidence that sits between review media and social chatter.

Known Quirks

  • TikHub access is billed per request at roughly
    $0.0036/request
    , so
    via_tikhub
    should stay first in fallback only where the direct API win justifies spend.
  • TikHub search does not require local cookies or login state.
  • Evidence currently reflects note-body content only; comments are not included in this route.

⚠️ Known Issue: via_signsrv Account Restriction (code=300011)

XHS applies two-tier account restriction enforcement:

  1. With valid signing: restricted accounts return
    code=0, 成功
    but
    items=[]
    — silently empty, no error
  2. Without signing: returns
    code=300011, 当前账号存在异常,请切换账号后重试

This means: if

via_signsrv
returns 0 results, it may be a restricted account, not genuinely empty search results.

Trigger: New/unverified accounts, or accounts that triggered bot detection from excessive API calls.

Mitigation (implemented): When

via_signsrv
returns empty results, the search path probes
/api/sns/web/v2/user/me
. If the probe returns
code=300011
, the channel raises
AccountRestrictedError
(a subclass of
ChannelAuthError
) — the fallback chain switches to
via_tikhub
, and downstream surfaces can distinguish "account flagged" from "missing/expired credentials". The same exception type is also raised on the inline
code=300011
path (when the search response itself returns 300011).

Workaround: Use

autosearch login xhs
with a normal, actively-used XHS account.
via_tikhub
is unaffected (uses TikHub's own accounts).

Proactive check:

autosearch login xhs --check-health
probes the me endpoint with the currently-imported cookies and reports whether the account is flagged — without having to run a search. Exits 0 (healthy), 1 (flagged or missing cookies), 2 (unsupported platform).

Quality Bar

  • Evidence items have non-empty title and url.
  • No crash on empty or malformed API response.
  • Source channel field matches the channel name.