Claude × Higgsfield Seedance 2.0 — Full Setup Guide

What This Does

Claude Code uses the Playwright MCP to control your browser and automate video generation on Higgsfield. You describe a product or concept, Claude invokes a specialized Seedance 2.0 skill to engineer a production-quality prompt, then automatically navigates to Higgsfield, fills in the prompt, and hits generate — without you touching anything.

The workflow:

1. You type a brief (e.g. "3 KitKat ads")

2. Claude invokes the right skill and generates prompts

3. Claude opens Higgsfield via Playwright

4. Claude submits each prompt, waits for generation, moves to the next

Requirements

• Claude Code installed (CLI or VS Code extension)

• A Higgsfield account — higgsfield.ai

• Node.js + npx (comes with Node)

• Git

Setup

1. Add Playwright MCP (Global — works in every session)

claude mcp add -s user playwright npx '@playwright/mcp@latest'

2. Create Your Project Folder

mkdir -p ~/Documents/Code/experiments/higgsfield
cd ~/Documents/Code/experiments/higgsfield

3. Install the 15 Seedance Skills

Go to the GitHub repo and follow the install instructions:
github.com/beshuaxian/higgsfield-seedance2-jineng

⚠️ Important: The installer puts skills in ~/Library/Application Support/Claude/skills/ but Claude Code reads from ~/.claude/skills/. After running the installer, copy them to the right place:

cp -r ~/Library/Application\\ Support/Claude/skills/* ~/.claude/skills/

5. Add .mcp.json to Project Folder

Create a file called .mcp.json in your project folder:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

6. Add CLAUDE.md to Project Folder

Create a file called CLAUDE.md in your project folder (see full CLAUDE.md contents at the end of this guide).

7. Restart Claude Code

Full quit and reopen VS Code / Claude Code so the skills and MCP config load.

8. Approve the MCP Server

When you open the project in VS Code, you'll see a notification to approve .mcp.json — click Allow.

9. Log Into Higgsfield

In a new Claude Code session, run:

Use Playwright MCP to open <https://higgsfield.ai> in the browser and wait

A browser window will open. Log in manually. Come back to Claude and say "logged in."

How to Use

Generate and Submit Ads (One Session)

Open Claude Code in the higgsfield project folder and type:

3 video ads for [your product description]

Claude will:

1. Invoke the right skill and generate 3 prompts

2. Show you the prompts before submitting

3. Open Higgsfield via Playwright

4. Submit each prompt one at a time

5. Wait 1 minute between each, check for loading spinner

6. Report when each one is done

Examples

3 ads for KitKat chocolate bar

2 ads for InstaCarousel — SaaS that automates Instagram carousels, saves 5 hours per week

1 cinematic ad for a luxury coffee brand, use ref.jpg

Using a Reference Image (Image-to-Video)

Drop an image into the project folder and mention it:

3 KitKat ads, use ref.jpg

Claude will upload it to Higgsfield automatically for Image-to-Video mode (better quality than Text-to-Video).

The 15 Skills

Content Filter — Banned Words

Higgsfield's filter flags these even in innocent motion design contexts. Claude replaces them automatically, but good to know if you're writing prompts manually.

Troubleshooting

Playwright MCP not available in VS Code

1. Make sure .mcp.json exists in the project folder

2. Fully quit VS Code (not just reload window) and reopen

3. Approve the MCP notification when it appears

4. Run /mcp in Claude Code to confirm playwright is listed

Skills not loading

Make sure skills are in ~/.claude/skills/ not ~/Library/Application Support/Claude/skills/:

ls ~/.claude/skills/ | grep -E "^[0-9]"

Should show 01-cinematic, 02-3d-cgi, etc.

NSFW warning on Higgsfield

Claude should catch banned words automatically. If it slips through, check the prompt for words in the content filter table above and replace them manually.

Claude writes its own prompts instead of using the skill

Start a fresh session. If it keeps happening, do it in two steps:

1. Session 1: /07-ecommerce-ad → generate prompts → save to prompts.txt

2. Session 2: "Submit prompts from prompts.txt to Higgsfield"

Claude navigates to wrong URL

The correct URL is: https://higgsfield.ai/create/video

CLAUDE.md Reference

This file lives in your project folder and loads automatically every session. It tells Claude the workflow, skills, content filter rules, and Playwright instructions.

# Higgsfield × Claude — Seedance 2.0 Automation

This project automates video generation on Higgsfield using Seedance 2.0.

## ⚠️ CONTENT FILTER — READ BEFORE WRITING ANY PROMPT

Higgsfield's filter flags these words. Never use them:

| Never use | Always use instead |
|---|---|
| explosion, explodes, exploding | radial particle scatter, dynamic reveal |
| burst, bursts | radiates outward, fans out, expands, pulses |
| smashes, crashes, slams | transitions into, resolves into, shifts to |
| snap, snaps | separates, divides, parts cleanly |
| break, breaks, broken | separates, opens, reveals |
| crack, cracks | opens along the edge, parts at the seam |
| shatter, shards | separates cleanly, dissolves |
| pull-apart, tear, rip | gentle separation, parts along the seam |
| impact, collision | transition, shift, contact |
| blows up, detonates | transforms, morphs, reveals |
| crush, crushed | press, compress, flatten smoothly |
| fire, flame, burning, ignite | warm amber glow, luminance, warm light |
| destroy, obliterate | dissolve, transform, fade out |
| violent, aggressive | dynamic, energetic, bold, forceful |
| naked, bare, exposed, raw | clean, minimal, natural, uncoated |

Mandatory pre-submission check: Scan every word against the Never use column. If a banned word is found, replace ONLY that word with the safe alternative — do not touch anything else.

## Default Workflow

STOP. Before doing anything with Playwright, complete Step 1 fully.

Step 1 — INVOKE THE SKILL FIRST:
- Invoke the correct skill (e.g. /07-ecommerce-ad) and get the full prompt output
- Run content filter check — replace any banned words
- Show the final prompts to the user

Step 2 — THEN submit via Playwright:
- Only start Playwright after Step 1 is 100% complete
- Copy the prompt CHARACTER FOR CHARACTER into browser_type
- Do not remove headers, merge paragraphs, reformat, or change anything, verbatim
- The only allowed change is replacing banned words

Default settings (unless specified by the user):
- Model: Seedance 2.0
- Aspect ratio: 9:16
- Duration: 8 seconds
- Batch: 1 variation unless user specifies

## Generation Mode

Assume Higgsfield is already open, logged in, brand asset uploaded and selected. (if not ask user to login)

For each variation:
1. Navigate to <https://higgsfield.ai/create/video>
2. Click the prompt field, clear it, type the prompt
3. Click generate
4. Report: "Variation [X] submitted — waiting 1 minute..."
5. Wait 1 minute
6. Take one screenshot — if loading spinner still visible, wait another minute
7. Report: "✓ Variation [X] done — moving to next"
8. Repeat for next variation

## Playwright MCP Rules

Only use these tools — never use browser-use skill, never run Python:
- browser_navigate
- browser_click
- browser_type
- browser_screenshot
- browser_upload_file

If promo modal or cookie banner appears, dismiss it first.
Higgsfield URL: <https://higgsfield.ai/create/video>

## Skills

| Skill | Use when |
|---|---|
| /01-cinematic | Film-style, narrative, cinematic |
| /02-3d-cgi | 3D renders, CGI, Unreal Engine |
| /03-cartoon | 2D animation, cartoon |
| /04-comic-to-video | Comic panels, manga, storyboards |
| /05-fight-scenes | Action, combat, fight scenes |
| /06-motion-design-ad | SaaS, apps, software, tech products |
| /07-ecommerce-ad | Physical products, CPG, fashion, food |
| /08-anime-action | Anime, Japanese animation |
| /09-product-360 | 360° product turntables |
| /10-music-video | Beat-synced visuals, music content |
| /11-social-hook | Viral hooks, TikTok/Reels |
| /12-brand-story | Brand narrative, origin story |
| /13-fashion-lookbook | Fashion, runway, lookbook |
| /14-food-beverage | Food, drink, restaurant |
| /15-real-estate | Property tours, architecture |

## Prompt Engineering

Use the full skill output as-is — keep all structure, length, timing, and creative direction exactly as the skill generates it. Do not summarise or shorten.


## Reference Images

If user provides an image path, upload via browser_upload_file for Image-to-Video mode.