wix Site Management Skill
Purpose
Dynamically fetch and manage Wix sites that the user's access token has permission for. No pre-configuration needed!
Core Concepts
One Token, All Sites
A single WIX_ACCESS_TOKEN (from app installation) can access ALL sites in that Wix account. No need to configure sites manually!
Dynamic Site Discovery
On first use, call the Wix API to get all sites the token has access to. Cache this list for the conversation.
In-Chat Site Selection
User can switch sites anytime by saying "connect to site 3" - no restart needed!
API: List User's Sites
Endpoint: GET https://www.wixapis.com/v1/sites
Headers:
Authorization: {ACCESS_TOKEN}
Content-Type: application/json
Full curl command:
curl -X GET "https://www.wixapis.com/v1/sites" \
-H "Authorization: ${WIX_ACCESS_TOKEN}" \
-H "Content-Type: application/json"
Response:
{
"sites": [
{
"siteId": "331d0c05-2ab0-4edb-91a6-4078c7e500b9",
"siteName": "Joe's Surf Shop",
"url": "https://joesurfshop.com",
"namespace": "wix",
"isActive": true
},
{
"siteId": "d3942804-aa4a-4d96-909b-57867c27e8ff",
"siteName": "Jane's Boutique",
"url": "https://janesboutique.com",
"namespace": "wix",
"isActive": true
}
]
}
Workflow
First Time Use
- Check if site selected (read from
~/.claude/wix-selected-site.json) - If no site: Automatically fetch and display site list
- User selects: "connect to site 2"
- Save selection to
~/.claude/wix-selected-site.json - Proceed with the user's original request
Switching Sites
User can switch anytime:
User: "Show me my sites"
Claude: [Calls API, displays numbered list]
User: "Connect to site 3"
Claude: [Saves selection] ✓ Connected to: Jane's Boutique
User: "Show me products"
Claude: [Uses site 3 for API calls]
Site Selection Storage
File: ~/.claude/wix-selected-site.json
Format:
{
"siteId": "d3942804-aa4a-4d96-909b-57867c27e8ff",
"siteName": "Jane's Boutique",
"selectedAt": 1708598400000,
"url": "https://janesboutique.com"
}
Functions:
const { getSelectedSite, saveSelectedSite } = require('../lib/site-storage');
// Get current selection
const site = getSelectedSite();
// Save new selection
saveSelectedSite(siteId, siteName, url);
Display Format
When showing sites to user:
Your Wix Sites:
1. Joe's Surf Shop
ID: 331d0c05-2ab0-4edb-91a6-4078c7e500b9
URL: joesurfshop.com
Status: Active
2. Jane's Boutique
ID: d3942804-aa4a-4d96-909b-57867c27e8ff
URL: janesboutique.com
Status: Active
3. Test Store
ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
URL: teststore.com
Status: Active
To connect to a site, say: "connect to site 2"
Always Show Active Site
CRITICAL: Before ANY response involving store data, display:
[Site: Jane's Boutique]
This ensures user always knows which store they're working with.
Error Handling
No access token configured
Error: WIX_ACCESS_TOKEN not found.
Please configure in Claude Desktop:
1. Settings → Browse Plugins → wix-store-optimizer
2. Click "Customize"
3. Add: WIX_ACCESS_TOKEN = (your token from app installation)
4. Save and restart Claude
API call fails
Unable to fetch sites. Please check:
- Access token is valid
- Token hasn't expired
- You have permission to view sites
Create a new API key: https://manage.wix.com/account/api-keys
No sites found
No sites found for this access token.
Make sure:
- You installed the app on at least one site
- The token is from the correct Wix account
Common Patterns
Check if Site Selected
# Read selection file
cat ~/.claude/wix-selected-site.json 2>/dev/null
If empty/missing → Show site list
Get Site Name for Display
# Extract site name from selection
SITE_NAME=$(cat ~/.claude/wix-selected-site.json | jq -r '.siteName')
echo "[Site: $SITE_NAME]"
Save User's Selection
# After user says "connect to site 2"
# Get site 2 from the fetched list, then save:
echo '{"siteId":"d3942804...","siteName":"Jane's Boutique","selectedAt":...}' > ~/.claude/wix-selected-site.json
Integration with Commands
Every command should:
Check selection:
SELECTED_SITE=$(cat ~/.claude/wix-selected-site.json 2>/dev/null)If empty: Run site selection flow
Extract site ID:
SITE_ID=$(echo "$SELECTED_SITE" | jq -r '.siteId') SITE_NAME=$(echo "$SELECTED_SITE" | jq -r '.siteName')Display site name:
[Site: $SITE_NAME]Use in API calls:
curl ... -H "wix-site-id: $SITE_ID"
Benefits
✅ No manual site configuration - Fetched automatically ✅ Works with unlimited sites - Not limited to 3 ✅ Easy switching - "connect to site 5" ✅ Always up-to-date - Fetches latest site list ✅ One token - Access all sites in account ✅ No restart needed - Switch sites in chat
This is MUCH better UX than pre-configuring sites! 🎉