mcpField
H
higgsfield-image-auto

higgsfield-image-auto

github.com/akcodezクリエイティブ・メディア457299 回インストール28 週間前に更新
リポジトリ

higgsfield-image-auto について

Playwright を使って Higgsfield の画像生成を自動化するスキルです。プロンプトから画像を作る際に、生成前のモデル、アスペクト比、解像度、枚数を設定できます。

主な機能

  1. 01Higgsfield の画像生成を自動化
  2. 02複数の画像モデルに対応
  3. 03アスペクト比と解像度の設定
  4. 04画像枚数を 1～4 枚に設定
  5. 05生成画像の表示と確認

活用シーン

  1. 01テキストプロンプトから画像を生成
  2. 02画像モデルと出力設定を選択
  3. 03動画ワークフローで使う前に画像を確認

MCP 対応

ブラウザー操作には Playwright MCP プラグインが必要です。Playwright のブラウザーツールで Higgsfield に移動し、画像生成を設定して実行します。

インストール

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

$npx skills add https://github.com/akcodez/higgsfield-claude-skills --skill higgsfield-image-auto

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

詳細

Playwright による Higgsfield 画像の自動生成

このスキルは、Playwright ブラウザー自動化を使用して Higgsfield での画像生成フロー全体を自動化します。画像生成ページに移動し、プロンプトを入力して設定を調整し、「Generate」をクリックします。すべてハンズフリーで実行できます。

前提条件

  • Playwright のブラウザーセッションで higgsfield.ai にログイン済みであること
  • Playwright MCP プラグインが有効になっていること
  • 各 Playwright ツールは、初めて使用する前に ToolSearch で読み込むこと

入力要件

ユーザーが指定するもの：

  1. 画像用のテキストプロンプト（または、先に /ugc-hot-girl を実行して生成します）

任意の設定（デフォルト値は以下のとおりです）：

  • モデル：Soul 2.0（選択肢：Soul 2.0、Soul Cinema、Nano Banana Pro、Nano Banana 2、Seedream 5.0 lite、GPT Image 1.5、Grok Imagine、FLUX.2、Reve、Z-Image）
  • アスペクト比：3:4（選択肢：1:1、3:4、4:3、9:16、16:9、2:3、3:2）
  • 解像度：2k（選択肢：1k、2k、4k）
  • 画像枚数：1（選択肢：1～4）

モデル URL マップ

各モデルには専用の URL パスがあります。

モデルURL
Soul 2.0/image/soul-v2
Soul Cinema/image/soul-cinematic
Nano Banana Pro/image/nano-banana-pro
Nano Banana 2/image/nano-banana-2
Seedream 5.0 lite/image/seedream_v5_lite
GPT Image 1.5/image/openai_hazel
Grok Imagine/image/grok_image
FLUX.2/image/flux_2
Reve/image/reve
Z-Image/image/z-image

デフォルト：Soul 2.0（/image/soul-v2）— 写真のようにリアルなポートレートや UGC キャラクターに最適です。

自動化の流れ

ステップ 1：画像生成ページに移動する
browser_navigate → url: "https://higgsfield.ai/image/soul-v2"

ユーザーが別のモデルを指定した場合は、上の表を参照して soul-v2 を適切なモデルパスに置き換えます。

ページの読み込みを待ってからスナップショットを取得し、次の点を確認します。

  • ページタイトルにモデル名が含まれている
  • プロンプトのテキストボックスが表示されている
ステップ 2：プロンプトのテキストボックスを見つけてクリックする

スナップショットを取得します。次を探してください。

textbox [ref=eXX]

ページ下部の group [ref=eXX] 内にあります。プレースホルダーテキストは "Describe the scene you imagine" です。

テキストボックスの Playwright ID は [id="hf:tour-image-prompt"] です。Playwright がこのセレクターを自動的に使用する場合があります。

browser_click → ref: <textbox_ref>, element: "Image prompt textbox"
ステップ 3：プロンプトを入力する
browser_type → ref: <textbox_ref>, text: "<the image prompt>"

重要：slowly: true ではなく、デフォルトの fill メソッドを使用します。このテキストボックスは標準の入力欄であり、Lexical エディターではありません。

ステップ 4：設定を調整する（任意）

ユーザーがデフォルト以外の設定を希望する場合は、該当するボタンをクリックします。

アスペクト比 — 現在の比率（例："3:4"）が表示されているボタンを見つけます。

browser_click → ref: <ratio_button_ref>, element: "Aspect ratio selector"

次に、ドロップダウンから選択します。

解像度 — 現在の解像度（例："2k"）が表示されているボタンを見つけます。

browser_click → ref: <resolution_button_ref>, element: "Resolution selector"

画像枚数 — 増減ボタンを見つけます（"1/4" と表示されています）。

  • 枚数を増やすには "Increment" ボタンをクリックします（最大 4 枚）。
  • 枚数を減らすには "Decrement" ボタンをクリックします。

キャラクター／ムードボード — 右側のパネルに "CHARACTER" と "General" ムードボードが表示されています。切り替えるには "Change" をクリックします。

ステップ 5：生成する

フォームの状態をユーザーに見せるため、スクリーンショットを撮影します。

「Generate」をクリックする前に、ユーザーに確認を求めてください。クリックするとクレジットまたは無料生成回数が消費されます。

Generate ボタンを見つけてクリックします。

browser_click → ref: <generate_button_ref>, element: "Generate button"

Generate ボタンには、残りの無料生成回数が表示されます（例："Generate 4915 free gens left"）。

ステップ 6：生成を待つ
browser_wait_for → time: 15

Soul 2.0 での画像生成には、通常 10～20 秒かかります。

ステップ 7：結果を確認する

スクリーンショットを撮影します。新しく生成された画像は、ページ上部の History グリッドの最初の項目として表示されます。

画像全体を表示するには、グリッドの最初の項目をクリックします。"Asset showcase" ダイアログが開き、次の内容が表示されます。

  • 画像の全体プレビュー
  • プロンプトの詳細
  • アクションボタン：Overview、Upscale、Enhancer、Relight、Inpaint、Angles
  • 下部のアクション：Animate、Publish、Open in、Reference、Download
ステップ 8: ユーザーに報告する

画像の生成が正常に完了したことをユーザーに伝えます。UGC パイプラインの一部である場合は、この画像から動画を作成するために /seedance-auto-generate を使えることも伝えてください。

主な要素のパターン

以下のパターンを使うと、ページ内を移動しやすくなります。参照情報はセッションごとに変わるため、必ず最新のスナップショットを取得してください。

要素見つけ方
プロンプト入力欄Playwright ID が hf:tour-image-prompt の textbox
モデルセレクターモデル名（例：「Soul 2.0」）を含む group 内の button
アスペクト比比率のテキスト（例：「3:4」）とドロップダウン矢印を表示する button
解像度解像度（例：「2k」）とドロップダウン矢印を表示する button
画像数「X/4」のカウンターを表示する button "Decrement/Increment"
Color Transferbutton "Color Transfer New"
キャラクターパネル右側にある、「CHARACTER」ラベル付きの complementary セクション
生成ボタン無料生成回数を表示する button "Generate ..."
履歴グリッド複数の img "image generation" 子要素を含む generic コンテナー
最初に生成された画像履歴グリッドのコンテナー内にある最初の generic 子要素

エラー処理

  • ログインしていない場合：ページにログインプロンプトが表示されたら、ログインするようユーザーに依頼してください（! open https://higgsfield.ai）。
  • プロンプト入力欄が見つからない場合：入力バーが表示されないことがあります。ページを更新して再試行してください。
  • モデルを利用できない場合：モデルによってはサブスクリプションが必要です。アップグレードを促すメッセージが表示されていないか確認してください。
  • 生成に失敗した場合：グリッド内の画像に「Failed」ステータスが表示されます。再試行するか、プロンプトを簡潔にするよう提案してください。

パイプラインとの連携

このスキルは UGC パイプラインのステップ 2 です。

  1. /ugc-hot-girl — キャラクター画像のプロンプトを生成します
  2. /higgsfield-image-auto ← 現在のステップ — Higgsfield での画像生成を自動化します
  3. /seedance-auto-generate — 生成した画像を Seedance 2.0 の動画ページに送ります
画像から動画への流れ

ここで画像を生成すると、Seedance 2.0 の動画作成ページから自動的に利用できるようになります。

  1. /create/video?model=seedance_2_0 に移動します
  2. アップロード領域をクリックして、メディアダイアログを開きます
  3. 「Image Generations」 タブをクリックします
  4. 直近で生成した画像が 最初の項目 として表示されます
  5. 画像をクリックして選択します（「Check eligibility」ボタンから、緑色のチェックマークが付いた選択状態に変わります）
  6. Escape キーを押してダイアログを閉じると、画像が動画フォームに読み込まれます

ファイルのダウンロードやアップロードは不要です — Higgsfield の内部アセットシステムにより、画像生成結果が動画作成に直接連携されます。

コメント

Markdown 対応