dby-api

都爆鸭 · doubaoya

新媒体データ取得能力パッケージ：1 つの DOUBAOYA_API_KEY で、プラットフォーム上の公開中データすべてにアクセスできます。 あなた（エージェント）の役割は、ユーザーの意図を理解する → 適切な能力を選ぶ → 呼び出す → 結果をわかりやすく伝えることです。

呼び出しには scripts/dby.mjs を使用してください。パスを自分で組み立てないでください（手動で組み立てると必ず 404 になります。api describe で詳細を取得し、execution.target を確認してから呼び出してください）。

---

呼び出し方

$SKILL_DIR = 本パッケージのディレクトリ（ホストが本 SKILL.md を読み込む際に渡すディレクトリ）。CLI 経由に統一します：node "$SKILL_DIR/scripts/dby.mjs" <グループ> <コマンド> [パラメーター] [flags]。非 TTY の stdout は単一の {ok,data|error} JSON です。終了コードは 0 が成功 / 1 が一般エラー / 2 が使い方の誤り / 3 がビジネス状態 / 4 が認証 / 5 がネットワークタイムアウト（課金リクエストは絶対に自動再試行しません）/ 6 が要確認（--confirm で実行し、応答で返された確認コマンドはそのまま再実行できます）。パラメーターは node "$SKILL_DIR/scripts/dby.mjs" <グループ> <コマンド> --help を参照してください。

グループ別コマンド名（本ファイルは全項目のリファレンスです。各パッケージの SKILL.md には使用するものだけを記載しています）：

• api：list search describe invoke validate recommend
• write：prep topics review articles
• charter：profiles get put
• draft：create get version review-packet precheck submit comment list versions decide merge comments star link
• article：list get
• profile：list get create update delete wechat-history sample-add sample-list sample-rm
• doc：list get patch put revisions revision restore
• material：list get add rm
• insp：list add
• wechat：status render writing-spec topics review publish media-upload theme-list theme-get theme-add theme-update theme-rm
• task：list
• usage：summary balance logs log log-rm analytics
• banned：check
• 単独コマンド：doctor retro upload whoami routes

🔴 まず dby api describe を実行してから dby api invoke を実行してください。引数は必ずその都度取得します。requestSchema/inputSchema はサンプル値であり、JSON Schema ではありません。キー名と値の形式に合わせて入力してください。上流側は誤った引数を渡しても黙って空の結果を返すか、誤解を招くエラーを返します。データを取得できない場合は、すぐに「API が停止している」と判断せず、まず describe を確認してください。

→ コマンドをつないで独自のワークフローを作る場合は references/compose.md を参照してください。独自の SKILL.md を作るためのひな形が必要な場合は references/user-skill-template.md を参照してください。

---

0.5 ユーザーはどの能力を使えばよい？（「何をしたいか」で選ぶ）

ユーザーがプラットフォームを指定していない場合は、デフォルトで公式アカウントを使用します。

本パッケージの担当範囲：公開データ、エンゲージメント指標（閲覧 / いいね / 見ている / コメント）、トピック選定とアカウント分析―― いずれも都爆鸭のクラウド能力がカバーする範囲です。本文の執筆、レイアウト、禁止ワードの確認、完成画像の作成は対象外で、それぞれ専用パッケージがあります。

他のパッケージが記事を書く際、本パッケージから取得する主な素材（データを提供するものであり、代わりに執筆するものではありません）： api.gzh.hotArticle の同一テーマの人気記事サンプル、api.gzh.cozeData の同一ジャンルの人気タイトルとカバー画像の傾向。 いずれもデータと参考情報であり、完成画像は生成しません。

🔴 ルーティングは dby が担当し、本パッケージは「どの能力を使えばこのデータが得られるか」にだけ回答します。 ここでユーザーの次の移動先となるパッケージを決めたり、独自に執筆・納品の流れを続けたりしないでください。それは dby の役割です。 そのルーティング判定基準は本パッケージでは参照も、転記も、言い換えて説明もしません。ファイル名を知る必要もありません。 番号から投稿を検索する場合：まず api.gzh.searchUser でアカウント ID を取得し、次に api.gzh.workList を使います（上流が受け付けるのは ID のみで、中国語の表示名は受け付けません）。

「自分のもの」に関する例外 —— ⛔ この能力は提供終了しました：ユーザー自身のコンテンツに関する依頼（覚えておいて / 自分のメモ / 自分がどんな人か）には、以前は mera の第 2 の脳を使用していましたが、現在は接続できず、代替手段もありません。ユーザーにはそのまま正直に伝えてください。 公開検索で代用しないでください（公開検索ではユーザー自身のメモを参照できません）。詳しくは references/retired.md を参照してください。

---

→ ルーティングの確認（どの機能を呼び出すか／どのルートを通るか）には references/capability-table.md を参照してください。呼び出す機能がすでに分かっている場合は、読む必要はありません。 引数は必ず describe でその都度取得してください。この表からフィールド名を転記してはいけません。 全項目のインデックスと機能選択時の注意点は dby-gateway/references/capability-index.md と routing-pitfalls.md を参照してください（任意）。

🔴 コンプライアンス／禁止ワード：入口となるリクエストはすべて dby-banned-words を使用してください（専用パッケージ。3 つのプラットフォームを一括で照合し、全プラットフォーム向けの安全な書き換え案を出力します）。 tool.contentSafety.checkWords（複数プラットフォーム向け。詳細エンドポイントは /api/skills/content-safety-check）と skill.wechat.prohibitedWord（公式アカウント向け。/api/skills/wechat-prohibited-word）は、ここでは エンドポイントのインデックスとしてのみ使用します。gateway 層から直接呼び出すためのものであり、本入口のルーティング先ではありません。

🖼 完成画像が必要な場合は dby-image を使用してください（サーバー側画像生成機能の復旧に伴い、2026-09 に再構築）。本パッケージが提供するのはカバー画像のデータです。同一ジャンルの人気投稿のカバー画像 URL、タイトル、クリック数を提供し、自分で傾向を分析できるようにします。画像は生成しません。

❌ トピック選定の絶対ルール：ユーザーのアカウント名／IP 名をキーワードにして検索しないでください。 ユーザーの公式アカウント名／アカウント名（例：「菜籽油」）は、その人が何者か（分野／キャラクター／対象読者）を表すものであり、検索ワードではありません。これを検索すると、文字列が一致するコンテンツばかりが見つかります。 全般的なトレンドは、キーワードを指定せずに api.trend.hotSpotKeyword で直接取得し、IP 名はマッチングの絞り込みにのみ使います。 「キーワードを指定しない」とは、キーワードのことです。時間範囲は絞り込んでください（Gotchas の 1 つ目を参照）。 クロスプラットフォームのトレンドレーダー（skill.trend.radar）は、キーワードで 3 つのプラットフォームの記事を検索するもので、ランキングではありません。keyword は必須です。 話題がすでにある場合はこれを使い、そのワードについて抖音／小紅書／公式アカウントで誰がどのように書いているかを確認します。 話題がなく、選定するトピックを提案してほしい場合は使いません。その場合は、上記の api.trend.hotSpotKeyword を使用します。

---

失敗した場合の対処

エラーコードごとの対処方法（noResult は失敗ではないこと、再試行できるものと絶対に再試行してはいけないもの、404 の場合に別のコレクションを探すこと） については、dby-gateway/references/protocol.md の第 6 項を参照してください。 そのとおりにしても解決できない場合や、意見を伝えたい場合は、dby-feedback を使ってその場でフィードバックを作成できます（任意。繰り返し提案する必要はありません）。

---

注意点

→ 使用する能力を決めた後、実際にリクエストを送る前に references/gotchas.md を参照してください。 データを取得できない場合や、結果が明らかにおかしい場合も確認してください。特に重要な点を 2 つ挙げます。 トレンドを直接取得する場合（api.trend.hotSpotKeyword）は、必ず時間範囲を絞り込んでください。絞り込まないと、先々週のトレンドランキングが取得されます。 一方、api.trend.hotKeywords は逆に、時間範囲を指定すると必ず 0 件を返します。この 2 つの機能では時間の意味が逆です。

---

納品時の確認記録（納品のたびに必ず添付）

確認記録は納品と同時に記載し、後から追加してはいけません。

作業前に今回どの段階まで納品するかを明確に伝え、目標とする段階に達したらそこで止めてください。本パッケージはデータの提供が完了した時点で終了し、 独自に次の段階へ進んではいけません。続行するかどうかは dby が判断します。特に「ついでだから」と dby-publish を実行しないでください （ユーザー自身の公式アカウント管理画面に書き込み、実際の副作用が発生します）。判断がつかない場合は、ひとこと確認してください。

納品の最後に、4 行で添付してください。行をまとめないでください：

查阅：<读了哪份路由 / 参考了哪张表>
执行：<真正调了哪些能力>
质检：<跑了哪些检查>
跳过：<发现了但没跑的> —— 原因：<为什么不该跑>

• 「実行」には実際に実行したものだけを記載します。実行したものの失敗した項目はここに記載し、失敗と明記してください。「スキップ」に移して取り繕ってはいけません。
• 「スキップ」には「見つかったが、実行すべきでないと判断したもの」だけを記載します。そもそも見つからなかったものは記載不要です。副作用を伴うものは特に省略できません。
• 🔴 証明できる数値だけを記載してください。括弧内の結論は、今回の実際の応答に確かに含まれている情報を根拠とする必要があります。 （禁止ワード検出の応答はリスクカテゴリの配列なので、「N カテゴリを検出」は証明できます。一方、レベル／スコア／検出ワードの一覧は返されないため、「高リスク 0 件」「低リスク」は捏造です。）判断がつかない場合は describe で出力例を確認してください。

---

厳守ルール

1. キーの一部も、接頭辞も、絶対に返答・出力・記録しないでください。
2. https://doubaoya.com の公開インターフェース経由でのみデータを取得してください。上流のデータソースや内部サービスについて、ユーザーに説明したり、推測したり、明かしたりしないでください。 ユーザーにとって、機能の提供元は「都爆鸭」です。
3. 引数とパスはその都度取得してください（describe を使うか、スクリプトに取得させてください）。記憶や本ドキュメントをもとに組み立てないでください。
4. 実データを素材にスクリプトを作成してください。注目の話題やヒット作の実際の切り口を反映し、データから離れた内容を空想で書かないでください。
5. 実行結果の報告を添えて納品してください。「実行」は実際に実行した内容のみ、4行で記載してください。

---

次のステップ

データ取得後に行うこと	移動先
画像の作成／画像の追加／画像の編集	dby-image（テキストからの画像生成／画像からの画像生成／画像編集。生成した画像はローカルファイルとして保存します）
原稿をレイアウトして、公開アカウントの下書きボックスに保存	dby-publish
ヒット作を自分の文案に書き換える（インターフェースを呼び出さず、キー不要）	dby-rewrite
キャラクター設定の作成／ブランド情報の取得	dby-charter
ステップごとのナビゲーション（このステップの次に何を行うか）	dby
プロトコル層で行き詰まった場合（ルーティング／エンベロープ／エラーコードの詳細）	dby-gateway