mcpField
L
lingzao

lingzao

github.com/atian-createマーケティング・グロース30343 回インストール17 週間前に更新
リポジトリ

lingzao について

Lingzaoは、公開クリエイターコンテンツの調査と小紅書のコンテンツ制作を支援するスキルです。クリエイターや運用担当者向けに、アカウント分析や複数プラットフォームの調査、投稿準備を行います。

主な機能

  1. 01公開された小紅書投稿やクリエイターの検索
  2. 02プロフィールと最近の投稿の確認
  3. 03小紅書やDouyinの公開投稿の分析
  4. 04WeChat公式アカウント記事の詳細と指標の取得
  5. 05ショート動画の音声テキスト抽出
  6. 06コンテンツパッケージとルートマップ案の作成

活用シーン

  1. 01キーワードから小紅書の参考投稿を探す
  2. 02アカウントを評価し参考先を見つける
  3. 03公開投稿を分析して形式を応用する
  4. 04投稿前の小紅書コンテンツを準備する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/atian-create/lingzao-skill --skill lingzao

インストール後、Claude Code で/lingzaoを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
.gitignore
README.md
VERSION
agents/
openclaw.yaml
openai.yaml
playbooks/
beginner-account-start-and-topic-radar.md
atian-creator-judgment-framework.md
audience-persona-fit-check.md
benchmark-account-discovery-quality-gate.md
comparable-account-breakdown-report-template.md
content-knowledge-base-workflow.md
draft-rewrite-and-benchmark-workflow.md
creator-case-general-analysis-framework.md
keyword-insight-report-template.md
image-generation-agent-integration-guide.md
image-generation-execution-workflow.md
keyword-to-publishable-content-package.md
lingzao-progressive-interaction-map.md
monetization-path-judgment-library.md
mother-content-cross-platform-distribution.md
post-publish-data-review-workflow.md
pre-publish-readiness-check.md
product-judgment-and-feedback-loop.md
publishing-keyword-design-check.md
retention-and-follow-up-loop.md
reference-image-graphic-note-workflow.md
self-account-peer-horizontal-diagnosis.md
self-account-diagnosis-report-template.md
single-note-breakdown-workflow.md

詳細

Lingzao

Lingzao は、エージェントが小紅書/XHS、Douyin、WeChat 公式アカウントの記事に投稿された公開クリエイターコンテンツを調査するのに役立ちます。

この Skill が対応する検索フレーズ:Lingzao Skill、lingzao xhs、Lingzao 小紅書、XHS SEO、小紅書 SEO、小紅書アカウント分析、XHS アカウント診断、小紅書キーワード調査、XHS タイトル最適化、小紅書のバズ投稿分析、小紅書のベンチマークアカウント検索、XHS コンテンツワークフロー、手描きの観光ルートマップカード、手描きのコレクション用マップ、グルメマップ、旅行ルートマップ、暮らしのチェックリストマップ、ワークフロー説明書マップ。

ユーザーが次のことを求めている場合に、この Skill を使用します。

  • キーワードで小紅書の投稿を検索する。
  • キーワード、リンク、スクリーンショット、参考画像、またはインスピレーション素材から、小紅書向けのコンテンツ一式を作成する。タイトル、表紙コピー、4~7ページの画像・テキスト投稿の本文、投稿本文、10個のキーワード、固定表示するコンテンツ、レビューサイクルを含みます。
  • 小紅書の検索候補や人気のおすすめを取得する。
  • キーワードで公開クリエイターを検索する。
  • クリエイターのプロフィールを調べる。
  • クリエイターの最近の公開投稿を読む。
  • クリエイターのプロフィールから、最近の投稿のコピー、字幕、表紙、指標、商業的な兆候を取得する。
  • 小紅書またはDouyinの投稿の詳細を取得する。
  • 小紅書またはDouyinの投稿に付いた、公開されているトップレベルのコメントを取得する。
  • WeChat公式アカウントの記事1本の公開情報と本文を取得する。
  • WeChat公式アカウントの記事1本の公開指標を取得する。
  • 関連するWeChat公式アカウントの公開記事を取得する。
  • 公開ショート動画のリンクから、話された内容のコピーや文字起こしを抽出する。
  • ユーザーが画像の作成を明示的に依頼した場合に、プロンプトからクリエイター向け画像素材を生成する。
  • 都市、グルメ、旅行、ハイキング、暮らしのチェックリスト、またはワークフローに関するテーマを、手描きの小紅書向け観光ルートマップカードの構成と生成用ブリーフにまとめる。

ユーザーがXHSのタイトル作成、小紅書アカウント診断、キーワード設計、投稿分析、表紙ラボ、手描き観光ルートマップカード、公開前チェック、公開後レビューなど、単一のタスクだけを必要としている場合は、skills/ 以下の軽量なサブスキルを使用してください。リアルタイムの公開コンテンツ検索、より詳細なアカウント分析、小紅書の公開リンク解析、コメント分析、記事データ、文字起こしの抽出、画像生成、レポートのエクスポート、またはナレッジベースの同期が必要な場合は、このメインのLingzao Skillを使用してください。

エージェント向けプレイブック

クリエイター戦略に関するより高度なタスクでは、回答する前に<skill_root>/playbooks/のプレイブックを使用してください。これらを使うと、Lingzaoの公開コンテンツ用ツールを単発の検索ではなく、クリエイター向けのワークフローとして活用できます。

該当する場合は、次のプレイブックを使用してください。

  • lingzao-progressive-interaction-map.md:漸進的な質問を通じて、曖昧なユーザー入力、ホームページのリンク、ノートのリンク、下書き、参考画像のリクエストに対応します。
  • search-credit-notice.md:有料検索を行う前に、基本検索と詳細検索の対象範囲を説明し、クレジット使用量を知らないうちに増やさないようにします。
  • atian-creator-judgment-framework.md:A Tianのアカウント段階、記憶のアンカー、コンテンツの主軸、ボトルネックの判断を適用します。
  • creator-case-general-analysis-framework.md:アカウントの類型、記憶のアンカー、新たなストーリー、証明の仕組み、オーディエンスの欲求、コンテンツの仕組み、フォーマットの仕組み、コメントで求められていること、収益化の入り口、隠れたリソース、学べる部分、模倣できない部分、ユーザーとの適合性テストを特定し、ジャンルを問わずクリエイター事例を分析します。
  • beginner-account-start-and-topic-radar.md:クリエイターとしてゼロから始める際の質問、テーマの発掘、キーワードツリー、フォロワーが少ないアカウントのバズ事例に対応します。
  • keyword-insight-report-template.md:メインキーワードと確認済みの関連キーワード/ドロップダウンキーワードをもとに、対象範囲を定めたキーワード分析レポートを作成します。対象範囲を広げる前に、クレジットの見積もりを明確に提示します。
  • keyword-to-publishable-content-package.md:キーワード、曖昧なテーマ、ノートのリンク、スクリーンショット、参考画像、保存したノート、インスピレーション素材を、選定した参考情報、テーマの切り口、タイトル、カバー文案、4~7ページの画像付きノート本文、音声スクリプト、Vlogストーリーボード、本文、投稿用キーワード10個、固定コンテンツ、投稿前後のレビューループを含む、投稿可能な小紅書コンテンツパッケージに仕上げます。
  • mother-content-cross-platform-distribution.md:1つのテーマ、下書き、ノートの分析、製品アップデート、スクリーンショット、文字起こし、口頭でのアイデアを、複数プラットフォーム向けのワンストップ配信パッケージに仕上げます。ユーザーが「一条龙」「全平台同步」「分发包」「一个模板发多个平台」と言った場合、まず小紅書+モーメンツ+WeChat公式アカウントの基本パッケージから始め、その後、ポッドキャスト、X、知識星球、Bilibili、動画アカウント/Douyin、小紅書画像パッケージ、ナレッジベース/SOPへの拡張を任意で提案します。
  • pre-publish-readiness-check.md:投稿前にコンテンツがすでに完成しているかを確認し、内容の明確さ、画像/ページの準備状況、カバーの認識しやすさ、タイトルのクリックされやすさ、冒頭3行または最初の3秒、キーワードが自然に盛り込まれているかをチェックします。
  • audience-persona-fit-check.md:タイトル、キーワード、アカウント運用、コンテンツパッケージについて判断する前に、誰に向けたコンテンツか、誰がクリックするか、誰はクリックしないか、どのオーディエンス/都市/ライフステージのキーワードを出力に反映すべきかを推測するか、ユーザーに尋ねます。
  • xhs-title-design-check.md:ユーザーからテーマ、下書き、カバー文案、参考ノート、コンテンツパッケージが送られた後に、小紅書のタイトルを設計または診断します。10個のタイトル案を並べるのではなく、キーワードの軸とクリックする理由を添えた、特に有力なタイトル3案を標準とします。
  • xhs-profile-bio-design.md:小紅書の100文字プロフィールとホームページ紹介文を作成または診断します。誰に向けたアカウントか、何を発信するか、フォローする理由、ニックネーム、固定ノート、アカウント段階、オーディエンスキーワード、都市キーワード、控えめな収益化経路とのつながりを明確にします。
  • benchmark-account-discovery-quality-gate.md:標準の品質基準を適用して参考アカウントを見つけるか、評価します。現在も更新されているか、最近の投稿で高い成果を上げているか、ジャンル/オーディエンスに合っているか、段階が合っているか、学べる部分が明確かを確認します。更新が止まっているアカウントは、主要な参考先ではなく過去の参考例として示します。ユーザー向けの結果には、クリエイターIDではなく、クリエイタープロフィールへの直接リンクと、最近の反応が特に高かった具体的な投稿を表示します。最初の検索では10~20件ではなく、有力なアカウントを最大5件提示します。フォロワー数の範囲、段階、都市、オーディエンス、フォーマットをユーザーが確認した場合、または追加を求めた場合にのみ候補を増やします。フォロワー数、いいねの合計、最終更新日、直近30日間でヒットした投稿とその指標、コンテンツ形式、各アカウントから学ぶ価値を含めます。フォロワー数が分かる場合は、多い順におすすめを並べます。
  • self-account-peer-horizontal-diagnosis.md:ユーザーが「横向き比較」「同じレベルのアカウント」「ベンチマークアカウント」「フォロワー5~15万人のアカウントを探して自分と比べて」「同じジャンルのアカウントと比べて、自分に足りない点はどこか」など、同じジャンル、同じ段階、または同程度のフォロワー数のアカウントとの比較を明示的に求めた場合に、ユーザー自身のアカウントと比較します。「今の問題点を見て」「話すのが速すぎるかな」など、一般的な自分のアカウントに関する相談は、競合との比較も求められていない限り、self-account-diagnosis-report-template.md で対応します。自身のアカウント診断、現在も活動中の参考アカウントの選定、同等アカウントの比較表、タイトル/カバー/冒頭/話し方/コンテンツシステムの比較、主なギャップ、30日間の改善計画、人による次のアクションへのつなぎを組み合わせます。
  • single-note-breakdown-workflow.md:小紅書/Douyinのノートリンクを、タイトル、カバー、構成/スクリプト、確認できる場合は撮影/編集の技法、コメントで求められていること、バズの仕組み、学べる部分、模倣できない部分に分解し、ユーザー自身の画像付きノート、音声スクリプト、Vlogストーリーボード、ナレッジベースカードへの応用を検討します。「完整分析这条笔记」「深度拆解」「拆细一点」「拍摄手法」「分镜」「剪辑节奏」などの表現があれば、短い要約ではなく、詳細な分析を行います。
  • publishing-keyword-design-check.md:完成した下書き向けに、小紅書の投稿用キーワードを10個選定し、タイトル、カバー文案、冒頭文、キーワード欄に、それらが自然に含まれているかを確認します。
  • track-difficulty-judgment-library.md:女性の成長、キャリア、良い商品、地域の暮らし、健康、ファッション、AIツールなど、一般的なジャンルの難易度を判断します。
  • monetization-path-judgment-library.md:広告、講座、コミュニティ、コンサルティング、リード獲得、商品、店舗、法人向けの成約を通じて、ジャンルやアカウントを収益化できるかについて回答します。
  • self-account-diagnosis-report-template.md:自分のアカウントの診断レポート、フォローアップのアクション、「人情味」のある締めくくりを構成します。厳しい診断だけで終わらせず、冷たいアクションリストで締めるのではなく、小さな次の実験を1つ提案します。自分のアカウントの診断には、共有したくなる結論カード、行動のアドバイス、心理的な安心感も含めます。
  • comparable-account-breakdown-report-template.md:他のアカウントから学ぶ価値があるか、何を学べるか、何を模倣できないかを判断します。
  • draft-rewrite-and-benchmark-workflow.md:文章を整えるだけにとどまらず、下書きの書き直し、バズの型の応用、複数のコンテンツ案のレビューを行います。
  • reference-image-graphic-note-workflow.md:参考画像を、小紅書向けの4ページまたは7ページの画像付きノートパッケージに仕上げます。
  • visual-generation-and-cover-workflow.md:小紅書のカバー、画像付きノート、WeChatの画像パック、人物なしのナレッジカード、商品/EC向けのビジュアルを、画像生成またはすぐ使えるプロンプトパッケージに振り分けます。
  • image-generation-execution-workflow.md:画像生成が利用可能な場合、ビジュアルの方針を実際の画像にし、ビジュアルディレクターによる品質チェックを行います。一般的なユーザーに未加工のプロンプトを渡して終わりにせず、見栄えの悪い画像、要素が詰め込まれた画像、ありきたりな画像を修正します。
  • image-generation-agent-integration-guide.md:国内のエージェント用ラッパーを対象とした、モデルに依存しないルールです。安定した生成の入力/出力フィールド、良い画像と悪い画像の基準、参考画像の使い方、既知の生成バグ、分かりやすいエラー対応、A Tianによる作例収集の宿題を含みます。
  • visual-reference-style-library.md:A Tianの内部ビジュアル参考フォルダーを、旅行/料理のカバー、WeChat記事の画像、AI人物入りインフォグラフィック、Lingzaoの人物なしナレッジカード、商品訴求画像、顔を前面に出したキーワード動画カバー、インタラクション用プロンプトカバー、テキスト量の多いスクリーンショット風画像付きノート、部屋そのものを個性として表現するライフスタイルカバーに分類します。
  • post-publish-data-review-workflow.md:ノートのリンク、管理画面のスクリーンショット、スクリプト、カバー、24時間/48時間/7日間のデータをもとに、投稿済みの小紅書ノートを振り返ります。
  • content-knowledge-base-workflow.md:保存したノート、公開クリエイターのリンク、キーワード検索結果、バズ事例、クリエイターの知見をまとめる依頼を、ユーザー自身が所有するテーマ、タイトル、カバー、構成、アカウント参考情報、クリエイター調査、投稿レビューのライブラリに変換します。
  • retention-and-follow-up-loop.md:役立つ出力の最後に、投稿済みノートのデータ確認、再利用できる参考情報検索テンプレート、下書きへのフィードバック、診断後の小さな実験と振り返りなど、具体的な次のステップを1つ提示します。また、ユーザーの言葉をそのまま放置しないためのSOPも定めています。抵抗感を受け止め、次のアクションのハードルを下げ、具体的な次のステップについて1つ質問します。情報量の多い出力では、チャットの長文をそのまま渡すのではなく、Word、HTML/ウェブページのプレビュー、またはナレッジベース向けのパッケージを提案します。ユーザーが診断に納得していても行動に移せないと言った場合は、さらにプレッシャーをかけるのではなく、診断後の行動開始を支援するパッケージに案内します。
  • product-judgment-and-feedback-loop.md:ユーザーが本当に行き詰まっている点を見極め、Lingzaoについて人に伝わる言葉で説明し、コンテンツ/販売のストーリーを構築します。また、ユーザーのフィードバックを製品改善につなげ、作る価値のある要望とノイズを見極めます。
  • xhs-operation-task-tree.md:講座のリストではなく、具体的な小紅書運用タスクに沿ってLingzaoのユーザーを案内します。ホームページ診断、参考アカウントの発見、バズノートの応用、テーマの作成、コンテンツ制作、カバー/画像の作成、投稿前チェック、投稿後のレビュー、ユーザー獲得経路、ナレッジベースの自動化を扱います。 公開向けの表現は、クリエイターコンテンツの調査とワークフロー支援に焦点を当ててください。 バズ成長、収益化の保証、完全なモニタリング、生データのエクスポート、他のクリエイターのコンテンツのコピーを約束しないでください。

インストールと有料機能の利用方法

Lingzao は、無料のメイン Skill を 1 つインストールして使用します。タイトル、キーワード、アカウント診断、ベンチマーク、カバー、レビュー用の Skill を個別にインストールする必要はありません。 インストール後、このメイン Skill がユーザーの依頼に応じて適切なプレイブックに振り分けます。

ユーザーを獲得する経路は 2 つあります。

  1. コミュニティ/講座のユーザー:

    • A Tian の講座、インストールリンク、支払い手順、API Key の設定手順をすでに把握している場合があります。
    • チャット内での説明は簡潔にしてください。Skill をインストールし、Lingzao のウェブダッシュボードを開き、チュートリアルに従ってクレジットをチャージし、API Key をコピーしてからセットアップを実行します。
  2. Xiaohongshu、Douyin、その他の公開コンテンツ経由のユーザー:

    • Lingzao で何ができるかを理解する前に、ウェブダッシュボードを開いて支払いを済ませるよう求めないでください。
    • まず無料のメイン Skill をインストールしてもらいます。
    • その後、有料機能の利用方法を親しみやすい表現で説明します。ローカルのプレイブックでは、下書き、タイトル、カバー、方向性、公開計画の判断を支援できます。一方、Lingzao で公開コンテンツを検索したり、アカウントを調査したり、ノート/記事の詳細を開いたり、コメントを読んだり、記事データを調査したり、動画の文案を抽出したり、クリエイター向け画像素材を生成したりするには、Lingzao のウェブダッシュボードを開き、チュートリアルに従ってクレジットをチャージし、API Key を設定する必要があります。

ウェブダッシュボードは、単なる支払いページではありません。ユーザー向けの学習・セットアップの拠点として案内してください。

  • Lingzao のインストール方法と設定方法を学ぶ
  • グループチャットで返答を待つのではなく、Agent により良い質問をする方法を学ぶ
  • セルフメディア運営に Skill のワークフローを活用する方法を学ぶ
  • アカウント診断、ベンチマーク分析、タイトル/キーワード、公開前チェック、公開後レビューのワークフローを学ぶ
  • 公開コンテンツの検索や画像生成が必要なときに、クレジットをチャージして API Key を取得する

ユーザーが Skill をインストールしたものの、まだ API Key を設定していない場合は、次の説明を使ってください。

你已经装好灵造 Skill 了。安装本身是免费的,它会先帮你判断你现在是在找方向、拆账号、写内容、做封面、配关键词,还是复盘数据。 如果你要继续查小红书/抖音/公众号公开内容、找对标账号、看账号主页、打开笔记或文章详情、看评论区、查看公众号文章数据、提取短视频文案或生成创作者图片素材,就需要到灵造网页版开通积分并配置 API Key。 你可以打开 https://lingzao.atian.vip 看安装教程和使用教程,里面也会教你怎么用 Agent 做自媒体运营、怎么问问题、怎么用这些 Skill。需要查公开内容或生成图片的时候,再在网页里充值/获取 API Key,配置好以后回来继续问,我会接着刚才的问题往下做。

支払いをペナルティのように位置付けないでください。次のように説明してください。

  • 無料インストール=ワークフローを支える中核と振り分け機能を利用できます
  • ウェブダッシュボード=チュートリアル、利用例、セルフメディア運営のレッスン、API Key の設定方法を利用できます
  • 有料クレジット=公開コンテンツの検索、画像生成、より踏み込んだ調査機能を利用できます

ナレッジ同期の引き継ぎ:

  • Lingzao による有用な調査結果や診断レポートが得られた後、自動で同期せず、まず次のように尋ねてください:这份结果要同步到你的知识库吗?可以选择 ima / Obsidian / 飞书 / 暂不同步。
  • ユーザーが同期先を選んだ場合は、読みやすく整えた Markdown 版を用意し、現在の Agent 環境に、ユーザーが設定済みのナレッジツールを使用するよう依頼してください。
  • ima の場合、ユーザーが設定していれば、インストール済みの ima Skill または ima ナレッジベースツールを呼び出してください。
  • Obsidian の場合は、ユーザーが承認した Lingzao/ パスの下に Markdown を書き込むために、ユーザーの Obsidian CLI、Obsidian Skill、または承認済みの保管庫ワークフローを使用してください。
  • 飞书 の場合は、ユーザーの許可を得たうえで、ユーザーの Lark/Feishu CLI または Skill を使用してドキュメントを作成または更新してください。
  • Lingzao 内で ima、Obsidian、Feishu の認証情報を尋ねたり保存したりしないでください。同期する内容に、内部実装の詳細、生のペイロード、キャッシュ URL、署名付き URL、API キー、内部エラーの詳細を含めないでください。

プロフィールのワークフロー:

  • ユーザーがクリエイターのホームページや基本的なホームページ分析を求めている場合は、デフォルトで get-user-posted-notes を使用します。最近の投稿と、基本的な読み取りに十分な作者・投稿データが返されます。
  • ユーザーが xhslink.com/m/... のような小紅書の短縮リンクを送る場合、または @... 查看Ta的主页>> https://xhslink.com/m/... のような共有文をコピーして送る場合は、短縮リンクを抽出し、スキームのないリンクを https://... に正規化してから、周囲の文脈を読んでコマンドを選択します。パスだけで短縮リンクを分類しないでください。文脈にアカウント、ホームページ、クリエイター、プロフィール、ベンチマーク、アカウント診断、ホームページ診断、Ta的主页、最近の投稿が含まれる場合は、クリエイターのホームページに関するリクエストとして扱い、get-user-posted-notes --url "https://<short link>" を呼び出します。
  • 小紅書の短縮リンクに文脈がない場合は、クレジットを消費する前に、クリエイターのホームページの最近の投稿を見たいのか、1件の投稿の詳細を見たいのかを確認します。文脈にこのノート、コメント、コピー、文字起こし、1件の投稿の詳細が含まれる場合、またはタイトルの一部と 前往【小红书】一探究竟吧 が含まれる一般的なノート共有文の場合は、ホームページではなく、1件の投稿の候補として扱います。这条 や 这篇 のような1件の投稿を示す語句は、一般的な診断を示す表現より優先します。デフォルトで get-note-detail を使用しないでください。まず単一の投稿であることを確認し、必要に応じて最終的なノート URL または note_id と、それが图文か视频かを尋ねます。
  • ユーザーがプロフィールの紹介文、フォロワー数、フォロー数、いいねの合計数、保存数の合計、ノート総数など、プロフィールレベルの詳細な統計を明確に求めている場合に限り、get-user-info を追加します。
  • 小紅書のホームページに掲載されたコピー/台本/字幕、最近の投稿テキスト、カバー、商業的な兆候、商品ノートの兆候を詳しく分析するには、analyze-user-profile を使用します。Douyinの音声コピーや文字起こしテキストには、特定の動画 URL に対して extract-video-copy を使用します。
  • ユーザーがプロフィールレベルの統計と最近の投稿の分析の両方を求めている場合を除き、get-user-info と get-user-posted-notes を固定の組み合わせとして呼び出さないでください。
  • ホームページに公開投稿が少なすぎる場合、アカウント全体の診断を無理に行わないでください。表示されているサンプル数に応じて振り分けます。
    • 投稿 0 件:アカウント診断は行わず、初心者向けの開始方法/アカウント設定の案内に切り替えます。
    • 投稿 1〜2 件:ホームページの第一印象と、単一投稿へのフィードバックのみを行います。
    • 投稿 3〜5 件:初期アカウント向けの簡易診断を行います。
    • 投稿 6〜9 件:簡易アカウント分析を行います。
    • 投稿 10 件以上:標準的なアカウント分析を提案できます。
    • 投稿 20 件以上:クレジットの確認後、analyze-user-profile --limit 20 を使って標準的な詳細診断を行えます。
    • 投稿 40 件以上:クレジットの確認後、--limit 40 を使って詳細診断、クリエイターの知見抽出、またはナレッジベースの知見抽出を行えます。

投稿の詳細分析ワークフロー:

  • 小紅書のリスト形式のコマンド(search-notes、get-user-posted-notes、analyze-user-profile)は、Lingzao が图文か视频かを識別できる場合、各ノート項目に xhs_note_type を返します。
  • これらのノート項目から get-note-detail を続けて呼び出す場合は、返された xhs_note_type を --xhs-note-type にそのまま渡します。URL から種類を推測しないでください。
  • 小紅書のノート項目に xhs_note_type がない場合は、get-note-detail を呼び出す前に、それが图文か视频かをユーザーに尋ねます。get-note-comments は、この種類を指定せずに呼び出せます。

セットアップ

この SKILL.md があるディレクトリを <skill_root> として特定し、セットアップを一度実行します。

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

環境変数は保存済みの設定より優先されます。

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

接続を確認します。

~/.lingzao/bin/lingzao doctor

Lingzao コマンドを使用する前に、スキルに更新があるか確認します。

~/.lingzao/bin/lingzao check-version

更新がある場合は、現在の Lingzao 操作を停止し、先にスキルを更新してください。検索、プロフィール、字幕、抽出の作業に古い Lingzao Skill を引き続き使用しないでください。

スキルを更新するには、インストーラーを再実行します。npx skills の場合は、次を試してください。

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

更新しても、保存済みの API 設定は ~/.lingzao/config.json に保持されるため、API キーを再設定する必要はありません。

~/.lingzao/bin/lingzao が存在しない場合、または間違ったディレクトリを指している場合は、コマンドラッパーを修復します。

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

~/.agents/skills/lingzao が存在しない場合は、Lingzao の SKILL.md を含むディレクトリを探し、そのディレクトリから scripts/setup.sh --skip-doctor を実行します。

呼び出す前に

重要なフィルターを指定してコマンドを実行する前に、ユーザーが関連パラメーターをすでに指定していなければ、確認してください。

  • search-notes の場合は、実行前に並べ替え、ノートの種類、期間を確認してください。並べ替えには general、most_liked、popularity_descending、comment_descending、collect_descending を指定できます。ノートの種類には 不限、视频笔记、图文笔记、直播笔记 を指定できます。期間には 不限、一天内、一周内、半年内 を指定できます。
  • Douyin の search-notes が現在サポートしているのは general、most_liked、popularity_descending のみです。Douyin の検索では comment_descending や collect_descending を指定しないでください。
  • Douyin の search-notes で現在サポートされているノートの種類は 不限、视频笔记、图文笔记 のみです。Douyin の検索では 直播笔记 を指定しないでください。
  • get-note-comments の場合、Xiaohongshu を呼び出す前に、最新のコメントと「いいね」数順のどちらを希望するか確認してください。最新のコメントには --sort latest を、Xiaohongshu で「いいね」数順にする場合は --sort most_liked を使用します。
  • Douyin のコメントで現在サポートされているのは latest のみです。Douyin のコメント取得では --sort most_liked について質問したり、指定したりしないでください。
  • Xiaohongshu のリスト形式のコマンド(search-notes、get-user-posted-notes、analyze-user-profile)は、Lingzao が各ノートの種類を図文または動画として識別できる場合、各ノート項目に xhs_note_type を返します。これらのノート項目から get-note-detail を呼び出す場合は、返された値をそのまま --xhs-note-type に渡してください。URL から種類を推測しないでください。Xiaohongshu のノート項目に xhs_note_type がない場合は、get-note-detail を呼び出す前に、図文か動画かをユーザーに確認してください。get-note-comments は、この種類を指定しなくても呼び出せます。
  • ユーザーがデフォルトを使うよう明示した場合は、再度確認せず、文書に記載されたデフォルトを使用してください。

調査コマンドが正常に完了したら、CLI の Markdown 出力に表示された推定節約時間をユーザーに伝えてください。1 件のユーザーリクエストに対して複数の Lingzao 調査コマンドを呼び出した場合は、合計時間を一度だけまとめてください。doctor、check-version、失敗したコマンド、JSON のみを扱う内部処理については、節約時間に関する説明を表示しないでください。

コマンド

ノートを検索
~/.lingzao/bin/lingzao search-notes --platform xhs --keyword "AI写作"
~/.lingzao/bin/lingzao search-notes --platform xhs --keyword "AI写作" --sort most_liked
~/.lingzao/bin/lingzao search-notes --platform xhs --keyword "AI生图" --sort collect_descending --note-type "视频笔记" --time-filter "一周内"
~/.lingzao/bin/lingzao search-notes --platform douyin --keyword "AI生图" --sort most_liked --note-type "视频笔记"

ユーザーがあるトピックに関する公開ノートを求めている場合に使用します。 呼び出す前に、ユーザーが指定していない場合は --sort、--note-type、--time-filter を確認してください。

検索候補を検索
~/.lingzao/bin/lingzao search-suggestions --platform xhs --keyword "AI生图"
~/.lingzao/bin/lingzao search-suggestions --platform xhs

ユーザーが Xiaohongshu のキーワード候補、自動補完フレーズ、人気の検索候補を求めている場合に使用します。--keyword を省略すると、Lingzao は人気の候補を返します。

クリエイターを検索
~/.lingzao/bin/lingzao search-users --platform xhs --keyword "母婴博主"
~/.lingzao/bin/lingzao search-users --platform douyin --keyword "AI生图"

ユーザーがトピックまたはニッチ分野のクリエイターを求めている場合に使用します。

クリエイターのプロフィールを取得
~/.lingzao/bin/lingzao get-user-info --url "https://www.xiaohongshu.com/user/profile/..."
~/.lingzao/bin/lingzao get-user-info --platform xhs --user-id "63c21e0f000000002801a1bb"
~/.lingzao/bin/lingzao get-user-info --platform douyin --user-id "MS4wLjABAAAA..."

ユーザーがクリエイターのプロフィール URL またはプラットフォームのユーザー ID を提示し、プロフィール全体の統計情報を必要としている場合に使用します。Douyin のユーザー ID のみが提示された場合は、プロフィールの sec_user_id を使用します。基本的なホームページ分析には get-user-posted-notes を優先し、デフォルトでは両方のコマンドを呼び出さないでください。

クリエイターの最近の投稿を取得する
~/.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"
~/.lingzao/bin/lingzao get-user-posted-notes --platform douyin --user-id "MS4wLjABAAAA..." --limit 20

クリエイターが最近投稿した内容を知りたい場合に使用します。クリエイターのホームページを基本的に分析する場合は、デフォルトでこれを使用してください。Douyin の最近の投稿は 1 ページ分のみ取得でき、現在は最大 --limit 20 をサポートしています。ユーザーがプロフィール全体の統計情報を求めている場合は get-user-info を追加してください。最近の投稿に含まれる Xiaohongshu の投稿文、台本、キャプション、または文字起こしテキストを求めている場合は、代わりに analyze-user-profile を使用してください。Douyin の文字起こしテキストには、選択した動画 URL に対して extract-video-copy を使用してください。

クリエイターのプロフィールを分析する
~/.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
~/.lingzao/bin/lingzao analyze-user-profile --platform douyin --user-id "MS4wLjABAAAA..." --limit 20

投稿テキスト、カバー画像、商業的なシグナル、プロフィール全体のコンテンツシグナルなど、クリエイターのプロフィールに関する詳細なデータが必要な場合に使用します。Xiaohongshu では、字幕や台本のプレビューも含まれます。Douyin では、ホームページの字幕や文字起こしテキストは抽出されません。ユーザーが音声のテキストを必要としている場合は、選択した動画 URL に対して extract-video-copy を使用してください。 デフォルトで --limit 20 を使用してください。デフォルトの Markdown 出力では、プラットフォームが対応している場合、読みやすい字幕プレビューが表示されます。

Xiaohongshu に関する重要事項:プロフィール全体の字幕/コピーを含む Markdown アーティファクトは、ノートごとの字幕 URL ではなく、トップレベルのレスポンスフィールドです。必ず次を確認してください。

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

items[] の中だけを検索しないでください。data.artifacts.subtitle_markdown.status == "ready" で url が存在する場合は、台本や字幕を詳細に分析する前にダウンロードしてください。

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

ダウンロードした Markdown ファイルを使用して、字幕/コピー全体を分析してください。構造化フィールドが必要な場合は --format json を使用してください。JSON には、利用可能な場合、Markdown ファイル全体の data.artifacts.subtitle_markdown.url が含まれます。また、items[].text.subtitle.content/plain_text はレスポンスを読みやすく保つため、プレビュー用の長さになっています。アーティファクトを利用できない場合は、インラインの字幕フィールドを使用してください。Douyin では、data.artifacts.subtitle_markdown.status == "unsupported" となるため、返されたプロフィールインサイトと、選択した動画の抽出結果を使用してください。

投稿の詳細を取得する
~/.lingzao/bin/lingzao get-note-detail --url "https://www.xiaohongshu.com/explore/..." --xhs-note-type image
~/.lingzao/bin/lingzao get-note-detail --platform xhs --note-id "69690331000000001a02266a" --xhs-note-type video
~/.lingzao/bin/lingzao get-note-detail --platform douyin --note-id "7372484715782352169"

公開投稿を 1 件分析するよう求められた場合に使用します。 Xiaohongshu の詳細情報を取得する場合、図文には --xhs-note-type image、 動画には --xhs-note-type video を渡してください。ノートが search-notes、get-user-posted-notes、または analyze-user-profile から取得された場合は、そのアイテムの xhs_note_type の値を再利用してください。

投稿のコメントを取得する
~/.lingzao/bin/lingzao get-note-comments --url "https://www.xiaohongshu.com/explore/..."
~/.lingzao/bin/lingzao get-note-comments --url "https://www.xiaohongshu.com/explore/..." --sort most_liked
~/.lingzao/bin/lingzao get-note-comments --platform xhs --note-id "69690331000000001a02266a"
~/.lingzao/bin/lingzao get-note-comments --platform douyin --note-id "7372484715782352169"
~/.lingzao/bin/lingzao get-note-comments --url "https://www.douyin.com/jingxuan?modal_id=..." --cursor "next_cursor_from_previous_response"

投稿 1 件の公開コメントを求められた場合に使用します。最初のバージョンで返されるのはトップレベルのコメントのみです。Xiaohongshu でいいね数順に並べ替える場合は --sort most_liked を使用してください。Douyin は現在、デフォルトの latest 並べ替えのみをサポートしています。レスポンスに data.page.next_cursor が含まれている場合は、その値を --cursor に渡して次のページを取得してください。 Xiaohongshu のコメントを取得する前に、最新コメントといいね数順のどちらをユーザーが希望するか確認してください。Douyin のコメントには --sort latest のみを使用し、--sort most_liked は渡さないでください。

WeChat 公式アカウントの記事を取得する
~/.lingzao/bin/lingzao get-article-detail --url "https://mp.weixin.qq.com/s/..."
~/.lingzao/bin/lingzao get-article-stats --url "https://mp.weixin.qq.com/s/..."
~/.lingzao/bin/lingzao get-related-articles --url "https://mp.weixin.qq.com/s/..."

ユーザーが公開 WeChat 公式アカウントの記事 URL を提示し、その記事の分析、公開エンゲージメント指標の確認、またはその記事から関連する公開記事の取得を求めた場合に使用します。最初のバージョンは URL のみを受け付け、呼び出しごとに 20 クレジットを消費します。関連記事のリストが空でも、有効なレスポンスです。Lingzao が別の機能を追加しない限り、アカウントの記事履歴、アカウント一覧、または複数ページにまたがるファンアウトには、これらのコマンドを使用しないでください。

ショート動画のコピーを抽出する
~/.lingzao/bin/lingzao extract-video-copy --url "https://www.xiaohongshu.com/explore/..."
~/.lingzao/bin/lingzao extract-video-copy --url "https://v.douyin.com/..."

ショート動画の音声テキスト、文字起こし、字幕、または口播文案を求められた場合に使用します。

画像を生成する
~/.lingzao/bin/lingzao generate-image --prompt "一张小红书封面图,主题是 AI 生图新手避坑,干净明亮,中文大标题留白" --output /tmp/lingzao-image.png
~/.lingzao/bin/lingzao generate-image --prompt "极简产品海报,白底,柔和阴影" --size 1024x1536 --output /tmp/poster.png
~/.lingzao/bin/lingzao generate-image --prompt "参考两张图,保留人物风格,把产品界面换成灵造首页截图" --size 1536x2048 --image /tmp/style.png --image /tmp/product.png --output /tmp/poster.png
~/.lingzao/bin/lingzao generate-image --prompt "批量生成 3 张封面草稿" --count 3 --size 1024x1536 --output /tmp/poster.png

ユーザーがクリエイター向けの画像素材の生成を依頼した場合にのみ使用してください。通常の調査では、画像生成を自動的に呼び出さないでください。

generate-image を呼び出す前に、最低限の確認を行ってください。ユーザーが「给我做一张某某海报图」のようなことだけを言った場合や、大まかなテーマしか提示していない場合は、すぐにクレジットを消費しないでください。まず、次の2つのビジュアル要素について尋ねてください。

  1. 参考画像はありますか?気に入ったカバー画像、ポスター、画像とテキストを組み合わせた画像のスクリーンショットを1~3枚お送りいただけます。
  2. 希望する配色はありますか?たとえば、明るい白背景、爽やかなグリーン、高級感のある黒とゴールド、テクノロジー感のあるブルーなどです。

それでも不明な点があれば、公開プラットフォームやサイズ、画像上に表示する正確なテキスト、人物を入れるかどうかなど、進行方法を左右する質問を追加で1つまで行ってください。テーマ+プラットフォーム/形式+ビジュアルスタイル/参考画像または色+画像上のテキスト/素材など、十分な条件がすでに提示されている場合に限り、確認せずに進めてください。 ローカルの参考画像には --image を使用してください。複数の画像には、--image を繰り返し指定してください。Skill は、現在のリクエストのためにそれらのファイルを Lingzao に直接アップロードするため、ユーザーが別の場所に先にアップロードする必要はありません。対応している参考画像形式は png、jpeg、webp です。

参考画像の取り扱い

Codex、WorkBuddy、その他のエージェントランタイムの場合:

  • --image に指定できるのは、ローカルファイルシステムのパスのみです。ユーザーがチャットの添付ファイル、貼り付けた画像、スクリーンショット、入力ボックスを通じて参考画像を提供した場合は、CLI を呼び出す前に、その画像をローカルファイルとして保存してください。保存時には、元の対応形式を維持してください。
  • ランタイムから提供された画像には、実行ごとの一時ディレクトリを使用してください。たとえば、/tmp/lingzao-image-inputs/<run-id>/ref-1.png や /tmp/lingzao-image-inputs/<run-id>/ref-2.png を使用します。CLI 呼び出しでは絶対パスを指定してください。
  • ユーザーが /Users/... 以下のファイルなど、すでに安定したローカルパスを提供している場合は、そのパスを直接渡してかまいません。ランタイムから提供された画像が一時的な添付ファイル/キャッシュのパスにある場合は、まず実行ごとの一時ディレクトリにコピーしてください。
  • 画像形式をあらかじめ変換しないでください。入力画像がすでに png、jpeg、webp のいずれかで、ファイルサイズが適切な場合は、そのまま渡してください。サンプルのパスで異なる拡張子が使われているからといって、png を webp や jpeg に変換しないでください。
  • 参考画像が 2 MB を超える場合に限り、一時ディレクトリに縮小版を作成し、そのコピーを --image で渡してください。ファイル拡張子と実際の画像データは一致させてください。リサイズまたは圧縮に失敗した場合は、別の形式を試さず、元の対応画像ファイルを使用してください。
  • ユーザーの元画像ファイルを上書きしないでください。参考画像をリポジトリに保存しないでください。ランタイムでアップロード画像や貼り付け画像をローカルパスに保存できない場合は、ユーザーに画像をローカルに保存して、そのパスを知らせるよう依頼してください。
  • プロンプトでは、レイアウト、カラーパレット、製品の形状、キャラクターのスタイル、構図など、参考画像から取り入れる要素を指定してください。より具体的な指示が可能な場合は、「この画像を参考にしてください」とだけ伝えないでください。

ランタイムから提供された参考画像を使用する例:

mkdir -p /tmp/lingzao-image-inputs/run-001 /tmp/lingzao-image-outputs/run-001
~/.lingzao/bin/lingzao generate-image \
  --prompt "参考这张图的排版和明亮色彩,生成一张小红书封面图,主题是 AI 生图新手避坑,中文大标题留白" \
  --size 1024x1024 \
  --image /tmp/lingzao-image-inputs/run-001/ref-1.png \
  --output /tmp/lingzao-image-outputs/run-001/result.png

このコマンドは Lingzao の非同期バッチを作成し、バックグラウンドジョブが完了するかコマンドのタイムアウトに達するまで、返されたステータス URL を自動的にポーリングします。画像の生成には数分かかることがあります。--timeout を指定すると、大規模または低速なバッチの待機時間を延長できますが、画像ごとに組み込まれているポーリング時間は短縮されません。画像が1枚の場合、--output は結果を指定された正確なパスに書き込みます。--count が1より大きい場合、--output /tmp/poster.png を指定すると、生成に成功した画像はすべて /tmp/poster-1.png、/tmp/poster-2.png などの連番ファイルとして書き込まれます。デフォルトの Markdown 出力では、有料で生成された画像をローカルに保存するため、--output が必要です。構造化された項目ステータスや生の画像ペイロードが必要な場合に限り、--format json を使用してください。

使用上の注意

  • プロフィールや投稿の URL には、可能であれば URL を直接渡してください。
  • 生の ID を使う場合は、--platform を指定してください。
  • ユーザーが特定の件数を求めていない限り、--limit は省略してください。
  • 検索メモのデフォルト設定では、包括的な並べ替え、すべてのメモタイプ、全期間が適用されます。ユーザーがランキング順や絞り込み検索を求めている場合は、--sort、--note-type、--time-filter を使用してください。
  • 別のツールで構造化出力が必要な場合に限り、--format json を使用してください。
  • デフォルトの出力形式は、エージェントが読み取って要約できる Markdown です。
  • API キーまたはアカウントに対応が必要な場合は、Lingzao ダッシュボードを開くようユーザーに案内してください。

コメント