pinterest-search について
pinterest-search は、キーワードから公開 Pinterest 画像を調べるスキルです。ビジュアル調査向けに、画像 URL と元の Pin URL を整形し、画像アドレスで重複を除いた範囲付きの初回検索を行います。
主な機能
- 01キーワードによる Pinterest 画像検索
- 02画像リンクと Pin リンクの整形
- 03画像アドレスによる重複除去
- 04初回検索範囲の制限
活用シーン
- 01ムードボード用の画像ソース収集
- 02クリエイティブ向けのビジュアル参考探し
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill pinterest-searchインストール後、Claude Code で/pinterest-searchを入力して読み込まれたか確認します。
同梱ファイルreferences/search.mdreferences/shared-contract.md
詳細
Pinterest 検索
ユーザーがキーワードから始めて、公開 Pinterest 画像の証拠(画像アドレス、ムードボードのソース一覧、ビジュアルのインスピレーションリンクなど)を求めている場合に、このスキルを使用します。
キーワードのワークフローについて説明が必要な場合に限り、references/search.md を読みます。
役割
1 つのキーワードを、範囲を限定した Pinterest 画像のセットに変換します。結果をそれぞれ { image_url, pin_url, title } に正規化し、画像アドレスで重複を除外します。リクエストに答えられる最小限の初回検索を実行してから停止し、対象範囲、件数、特に有力な結果、次のアクションを報告します。
参照インデックス
| ユーザーの要望 | 適用 |
|---|---|
| キーワードによる Pinterest 画像検索 | 必要な場合に限り references/search.md |
| より広い検索:結果の追加、フィルターの変更、または 2 つ目のキーワード | references/search.md |
| ボードのスクレイピング、プロフィールのスクレイピング、ピン URL のスクレイピング、ショッピング/商品情報、エンゲージメント指標 | 現在の公開インターフェースではサポートされていません。その旨を伝えて停止します |
| Pinterest 以外の画像ソース | 引き継ぎます。この場では Pinterest の検索のみ実行します |
最初の質問
回答によって検索経路、初回検索の範囲、または出力形式が変わる場合に限り、質問を 1 つだけします。
| 不足情報 | 質問 |
|---|---|
| キーワード | Pinterest で何のキーワードを検索しますか? |
| 範囲が広すぎる | 初回検索で最も重要なキーワードを 1 つ選ぶとしたら、どれですか? |
| フィルターの意図 | すべてのピンを含めますか、それとも動画ピンのみを含めますか? |
認証情報、実装方法、スキーマフィールド、非公開フィルター、再試行方法についてユーザーに尋ねてはいけません。
実行手順
- 以下のコマンドを使用します。必要な場合に限り、
references/search.mdを読みます。 - 初回検索に答えられる最も限定的な収集を実行します。最小件数の 20 から開始します。
- 出力を
{ image_url, pin_url, title }に正規化し、画像アドレスで重複を除外します。 - 初回検索の後に停止し、対象範囲、件数、特に有力な結果、制限事項、次のアクションを報告します。
範囲を限定した初回検索を、Pinterest のカタログ全体として提示してはいけません。このルートで公開されているフィルターのみを使用します。
公開コマンドの範囲
-
次のコマンドを実行します:
postplus research run pinterest-search --query <keyword> --kind <all|videos> --limit <n> --wait --output <result.json>。最小件数は 20 です。 -
準備状況の診断:
postplus doctor --skill pinterest-search -
必要な場合に限り、フラグを確認するために
postplus research run pinterest-search --helpを確認します。 -
初回検索の範囲は限定し、最初の結果を確認してからのみ拡張します。
-
リクエストされたタスクでは、現在の価格と残高を確認したうえで、既存の PostPlus クレジットを使用します。 見積もりのみのリクエストでは実行しません。クレジットが不足している場合は停止し、チャージ、サブスクリプションの購入、または不確実な有料操作の繰り返しは行いません。
プラットフォームの対象範囲または証拠の解釈が不明なままの場合に限り、プラットフォーム契約を参照します。これは事前確認ではありません。
エビデンスの品質
- 使用可能な画像レコードとソース pin URL を保持します。画像のないレコードは破棄し、画像 URL で重複を排除します。
- 完了したパスが疎らであるか的外れな場合は、スコープ内で 1 つの絞り込んだキーワードまたはサポートされている kind の変更を試します。
- 成功したものの不十分な結果の後は、承認されたスコープと予算内で、変更したフォローアップパスを最大 2 回まで許可します。同一のリクエストを繰り返したり、失敗した/保留中の操作を隠したりしないでください。
- 十分になったとき、上限に達したとき、または別のパスが役に立たないときに停止します。有用なエビデンスと不確実性を報告し、生の結果とソースリンクを保持します。
image_url はアセット、pin_url はそのソースページです。欠落しているタイトルは欠落したままとし、視覚的なインスピレーションはエンゲージメントのエビデンスではありません。
完全なマシンフィールドは postplus research schema --route <route> --json に属します。
処理に必要な場合にのみ参照し、毎回のリクエストの前に参照しないでください。
postplus research run pinterest-search \
--query "example topic" \
--wait \
--output ./result.json
CLI の構造化された結果と報告された次のアクションに従ってください。フリーテキストのメッセージから復旧を推測しないでください。 要求されたスコープと最大コストをすでにカバーしている明示的なユーザーの承認を再利用してください。そうでない場合は、見積もりを確定する前に承認を取得してください。タスクだけから支出の承認を推測しないでください。 返されたチェックポイントまたはアクションを通じて同じ操作を再開してください。不確実な作業を再送信したり、使い果たした復旧を繰り返したり、失敗を回避するためにプロバイダーを切り替えたりしないでください。