mcpField
H
higgsfield-marketplace-cards

higgsfield-marketplace-cards

github.com/higgsfield-aiMarketing & growth1.8k196.6k installsUpdated 1d ago
Repository

About higgsfield-marketplace-cards

A Higgsfield CLI skill for creating marketplace product-image bundles from product details and optional images. It handles preset asset scopes or custom asset selections and returns generated image URLs.

Key features

  1. 01Marketplace image bundle generation
  2. 02Preset scopes and custom assets
  3. 03Optional product image input
  4. 04Product and brand context flags

Use cases

  1. 01Create a main marketplace product image
  2. 02Generate secondary images and A+ modules
  3. 03Build a custom subset of product visuals

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/higgsfield-ai/skills --skill higgsfield-marketplace-cards

After installing, type/higgsfield-marketplace-cardsin Claude Code to confirm it loaded.

Details

From the project README

Marketplace Cards

Create marketplace-ready product visuals with higgsfield marketplace-cards create. The CLI first calls the backend enhancer, where marketplace rules and templates are kept private, then creates nano_banana_2 jobs and prints result URLs.

Bootstrap

  1. If higgsfield is not on $PATH, install it by running the official installer with Bash: curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh.
  2. If higgsfield account status fails with authentication errors, ask the user to run higgsfield auth login.

UX Rules

  1. Respond in the user's language.
  2. Ask at most one concise confirmation question before running.
  3. Prefer a product image. If the user provides only text or a URL, proceed only when the product details are clear.
  4. Do not write final image-generation prompts yourself. Backend enhancement owns that.
  5. Final answer should contain only the ready image URLs and short labels.

Scope Selection

Use --scope when the user asks for a common bundle:

ScopeCreates
main1 marketplace main image
product-imagesmain image + 5 secondary images
aplusmain image + 7 A+ modules
full-setmain image + 5 secondary images + 7 A+ modules

Use repeated --asset only for custom subsets:

  • main_image
  • infographic
  • multi_angle
  • detail_shot
  • lifestyle
  • whats_in_box
  • aplus_hero_banner
  • aplus_pain_points
  • aplus_features
  • aplus_ingredients
  • aplus_efficacy
  • aplus_how_to_use
  • aplus_endorsement

Command

Build and run one higgsfield marketplace-cards create command from the user's request.

For common bundles, use --scope <main|product-images|aplus|full-set>, --prompt "<short product and listing intent>", optional repeated --image <path-or-upload-id>, and optional context flags: --product_context, --brand_context, --category, --visual_style.

Examples to mirror when choosing arguments:

  • Product images: higgsfield marketplace-cards create --scope product-images --prompt "sparkling peach lemonade can for marketplace listing" --image ./can.png --category "beverage"
  • Full set: higgsfield marketplace-cards create --scope full-set --prompt "premium skincare serum, clean clinical marketplace visual system" --image ./serum.jpg --brand_context "minimal white and sage palette"
  • Custom subset: repeat --asset, for example --asset main_image --asset infographic --asset lifestyle.
  • Existing completed main image job: use --main-job <completed_main_job_id> with the requested secondary or A+ --asset values.

Delivery

Print URLs with labels:

Marketplace cards ready:
- Main image: https://...
- Infographic: https://...
- Lifestyle: https://...

Avoid JSON, job IDs, internal model names, or enhanced prompt text unless the user explicitly asks.

Comments

Markdown supported