Autosearch

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.