lingzao

Use Lingzao creator-content research tools for Xiaohongshu/XHS and Douyin public content, including note search, creator search, profile lookup, recent posts, deep profile copy/subtitle analysis, note detail, and short-video copy extraction.

Lingzao helps agents research public creator content from Xiaohongshu and Douyin.

Use this skill when the user asks to:

• Search Xiaohongshu notes by keyword.
• Search public creators by keyword.
• Look up a creator profile.
• Read a creator's recent public posts.
• Get recent post copy, subtitles, covers, metrics, and commercial signals from a creator profile.
• Get details for a Xiaohongshu or Douyin post.
• Extract spoken copy or transcript from a public short-video link.

Profile workflow:

• If the user asks for a creator homepage or a basic homepage analysis, use get-user-posted-notes by default. It returns recent posts and enough author/post data for a basic read.
• Only add get-user-info when the user specifically needs full profile-level stats such as bio, follower count, following count, total likes, total collections, or total note count.
• Use analyze-user-profile when the user asks for deeper homepage copy/script/subtitle analysis, recent post text, covers, commercial signals, or product-note signals.
• Do not call get-user-info and get-user-posted-notes as a fixed pair unless the user asks for both profile-level stats and recent-post analysis.

Setup

Resolve this SKILL.md directory as <skill_root>, then run setup once:

bash "<skill_root>/scripts/setup.sh" --base-url "https://your-lingzao-domain.com"

Environment variables override saved config:

export LINGZAO_API_KEY="lgz_xxx"
export LINGZAO_BASE_URL="https://your-lingzao-domain.com"

Check the connection:

~/.lingzao/bin/lingzao doctor

Before using Lingzao commands, check whether the skill has an update:

~/.lingzao/bin/lingzao check-version

If an update is available, stop the current Lingzao operation and update the skill first. Do not continue using an outdated Lingzao Skill for search, profile, subtitle, or extraction work.

To update the skill, rerun the installer. For npx skills, try:

npx skills add https://assets-tian.midao.site/skills/lingzao --skill lingzao -g --copy

Updating keeps the saved API config in ~/.lingzao/config.json; no API key setup is needed again.

If ~/.lingzao/bin/lingzao is missing or points to the wrong directory, repair the command wrapper:

bash ~/.agents/skills/lingzao/scripts/setup.sh --skip-doctor

If ~/.agents/skills/lingzao does not exist, find the directory that contains lingzao's SKILL.md, then run scripts/setup.sh --skip-doctor from that directory.

Commands

Search Notes

~/.lingzao/bin/lingzao search-notes --platform xhs --keyword "AI写作"

Use this when the user wants public notes around a topic.

Search Creators

~/.lingzao/bin/lingzao search-users --platform xhs --keyword "母婴博主"

Use this when the user wants creators in a topic or niche.

Get Creator Profile

~/.lingzao/bin/lingzao get-user-info --url "https://www.xiaohongshu.com/user/profile/..."
~/.lingzao/bin/lingzao get-user-info --platform xhs --user-id "63c21e0f000000002801a1bb"

Use this when the user provides a creator profile URL or platform user ID and needs full profile-level stats. For basic homepage analysis, prefer get-user-posted-notes and avoid calling both commands by default.

Get Creator Recent Posts

~/.lingzao/bin/lingzao get-user-posted-notes --url "https://www.xiaohongshu.com/user/profile/..."
~/.lingzao/bin/lingzao get-user-posted-notes --platform xhs --user-id "63c21e0f000000002801a1bb"

Use this when the user wants to understand what a creator has posted recently. Use this by default for basic creator homepage analysis. If the user asks for full profile-level stats, add get-user-info; if the user asks for post copy, scripts, captions, or transcript text across recent posts, use analyze-user-profile instead.

Analyze Creator Profile

~/.lingzao/bin/lingzao analyze-user-profile --url "https://www.xiaohongshu.com/user/profile/..." --limit 20
~/.lingzao/bin/lingzao analyze-user-profile --platform xhs --user-id "63c21e0f000000002801a1bb" --limit 40

Use this when the user wants deeper creator profile data, including post text, subtitles, covers, and commercial signals. Use --limit 20 by default. The default Markdown output shows readable subtitle previews.

Important: the complete profile subtitle/copy Markdown artifact is a top-level response field, not a per-note subtitle URL. Always check:

data.artifacts.subtitle_markdown.status data.artifacts.subtitle_markdown.url

Do not search only inside items[]. If data.artifacts.subtitle_markdown.status == "ready" and url exists, download it before deep script or subtitle analysis:

curl -L "$subtitle_markdown_url" -o /tmp/lingzao-profile-subtitles.md

Use the downloaded Markdown file for complete subtitle/copy analysis. Use --format json when the user needs the structured fields. JSON includes data.artifacts.subtitle_markdown.url for the complete Markdown file when available, and inline items[].text.subtitle.content/plain_text are preview-sized to keep the response readable. If the artifact is unavailable, use the inline subtitle fields.

Get Post Detail

~/.lingzao/bin/lingzao get-note-detail --url "https://www.xiaohongshu.com/explore/..."
~/.lingzao/bin/lingzao get-note-detail --platform xhs --note-id "69690331000000001a02266a"
~/.lingzao/bin/lingzao get-note-detail --platform douyin --note-id "7372484715782352169"

Use this when the user asks to analyze one public post.

Extract Short-Video Copy

~/.lingzao/bin/lingzao extract-video-copy --url "https://www.xiaohongshu.com/explore/..."
~/.lingzao/bin/lingzao extract-video-copy --url "https://v.douyin.com/..."

Use this when the user asks for short-video spoken copy, transcript, subtitles, or口播文案.

Usage Notes

• For profile and post URLs, pass the URL directly when possible.
• For raw IDs, include --platform.
• Omit --limit unless the user asks for a specific count.
• Use --format json only when another tool needs structured output.
• Default output is Markdown for agents to read and summarize.
• If the API key or account needs attention, ask the user to open the Lingzao dashboard.