\n- CMS items are staged; use `PUBLISH_SITE` or set `live: true` to push to production\n\n### 2. Manage Sites and Publishing\n\n**When to use**: User wants to list sites, inspect site configuration, or publish staged changes\n\n**Tool sequence**:\n1. `WEBFLOW_LIST_WEBFLOW_SITES` - List all accessible sites [Required]\n2. `WEBFLOW_GET_SITE_INFO` - Get detailed site metadata including domains and settings [Optional]\n3. `WEBFLOW_PUBLISH_SITE` - Deploy all staged changes to live site [Required for publishing]\n\n**Key parameters for PUBLISH_SITE**:\n- `site_id`: Site identifier from LIST_WEBFLOW_SITES\n- `custom_domains`: Array of custom domain ID strings (from GET_SITE_INFO)\n- `publish_to_webflow_subdomain`: Boolean to publish to `{shortName}.webflow.io`\n- At least one of `custom_domains` or `publish_to_webflow_subdomain` must be specified\n\n**Pitfalls**:\n- `PUBLISH_SITE` republishes ALL staged changes for selected domains -- verify no unintended drafts are pending\n- Rate limit: 1 successful publish per minute\n- For sites without custom domains, must set `publish_to_webflow_subdomain: true`\n- `custom_domains` expects domain IDs (hex strings), not domain names\n- Publishing is a production action -- always confirm with the user first\n\n### 3. Manage Pages\n\n**When to use**: User wants to list pages, inspect page metadata, or examine page DOM structure\n\n**Tool sequence**:\n1. `WEBFLOW_LIST_WEBFLOW_SITES` - Find the target site_id [Prerequisite]\n2. `WEBFLOW_LIST_PAGES` - List all pages for a site with pagination [Required]\n3. `WEBFLOW_GET_PAGE` - Get detailed metadata for a specific page [Optional]\n4. `WEBFLOW_GET_PAGE_DOM` - Get the DOM/content node structure of a static page [Optional]\n\n**Key parameters**:\n- `site_id`: Site identifier (required for list pages)\n- `page_id`: 24-character hex page identifier\n- `locale_id`: Optional locale filter for multi-language sites\n- `limit`: Max results per page (max 100)\n- `offset`: Pagination offset\n\n**Pitfalls**:\n- `LIST_PAGES` paginates via offset/limit; iterate when sites have many pages\n- Page IDs are 24-character hex strings matching pattern `^[0-9a-fA-F]{24} \n- `GET_PAGE_DOM` returns the node structure, not rendered HTML\n- Pages include both static and CMS-driven pages\n\n### 4. Upload Assets\n\n**When to use**: User wants to upload images, files, or other assets to a Webflow site\n\n**Tool sequence**:\n1. `WEBFLOW_LIST_WEBFLOW_SITES` - Find the target site_id [Prerequisite]\n2. `WEBFLOW_UPLOAD_ASSET` - Upload a file with base64-encoded content [Required]\n\n**Key parameters**:\n- `site_id`: Site identifier\n- `file_name`: Name of the file (e.g., `\"logo.png\"`)\n- `file_content`: Base64-encoded binary content of the file (NOT a placeholder or URL)\n- `content_type`: MIME type (e.g., `\"image/png\"`, `\"image/jpeg\"`, `\"application/pdf\"`)\n- `md5`: MD5 hash of the raw file bytes (32-character hex string)\n- `asset_folder_id`: Optional folder placement\n\n**Pitfalls**:\n- `file_content` must be actual base64-encoded data, NOT a variable reference or placeholder\n- `md5` must be computed from the raw bytes, not from the base64 string\n- This is a two-step process internally: generates an S3 pre-signed URL, then uploads\n- Large files may encounter timeouts; keep uploads reasonable in size\n\n### 5. Manage Ecommerce Orders\n\n**When to use**: User wants to view ecommerce orders from a Webflow site\n\n**Tool sequence**:\n1. `WEBFLOW_LIST_WEBFLOW_SITES` - Find the site with ecommerce enabled [Prerequisite]\n2. `WEBFLOW_LIST_ORDERS` - List all orders with optional status filtering [Required]\n3. `WEBFLOW_GET_ORDER` - Get detailed information for a specific order [Optional]\n\n**Key parameters**:\n- `site_id`: Site identifier (must have ecommerce enabled)\n- `order_id`: Specific order identifier for detailed retrieval\n- `status`: Filter orders by status\n\n**Pitfalls**:\n- Ecommerce must be enabled on the Webflow site for order endpoints to work\n- Order endpoints are read-only; no create/update/delete for orders through these tools\n\n## Common Patterns\n\n### ID Resolution\nWebflow uses 24-character hexadecimal IDs throughout:\n- **Site ID**: `WEBFLOW_LIST_WEBFLOW_SITES` -- find by name, capture `id`\n- **Collection ID**: `WEBFLOW_LIST_COLLECTIONS` with `site_id`\n- **Item ID**: `WEBFLOW_LIST_COLLECTION_ITEMS` with `collection_id`\n- **Page ID**: `WEBFLOW_LIST_PAGES` with `site_id`\n- **Domain IDs**: `WEBFLOW_GET_SITE_INFO` -- found in `customDomains` array\n- **Field slugs**: `WEBFLOW_GET_COLLECTION` -- found in collection `fields` array\n\n### Pagination\nWebflow uses offset-based pagination:\n- `offset`: Starting index (0-based)\n- `limit`: Items per page (max 100)\n- Increment offset by limit until fewer results than limit are returned\n- Available on: LIST_COLLECTION_ITEMS, LIST_PAGES\n\n### CMS Workflow\nTypical CMS content creation flow:\n1. Get site_id from LIST_WEBFLOW_SITES\n2. Get collection_id from LIST_COLLECTIONS\n3. Get field schema from GET_COLLECTION (to learn field slugs)\n4. Create/update items using correct field slugs\n5. Publish site to make changes live\n\n## Known Pitfalls\n\n### ID Formats\n- All Webflow IDs are 24-character hexadecimal strings (MongoDB ObjectIds)\n- Example: `580e63fc8c9a982ac9b8b745`\n- Pattern: `^[0-9a-fA-F]{24} \n- Invalid IDs return 404 errors\n\n### Field Slugs vs Display Names\n- CMS operations require field `slug` values, NOT display names\n- A field with displayName \"Author Name\" might have slug `author-name`\n- Always call `GET_COLLECTION` to discover correct field slugs\n- Using wrong field names silently ignores the data or causes validation errors\n\n### Publishing\n- `PUBLISH_SITE` deploys ALL staged changes, not just specific items\n- Rate limited to 1 publish per minute\n- Must specify at least one domain target (custom or webflow subdomain)\n- This is a production-affecting action; always confirm intent\n\n### Authentication Scopes\n- Different operations require different OAuth scopes: `sites:read`, `cms:read`, `cms:write`, `pages:read`\n- A 403 error typically means missing OAuth scopes\n- Check connection permissions if operations fail with authorization errors\n\n### Destructive Operations\n- `DELETE_COLLECTION_ITEM` permanently removes CMS items\n- `PUBLISH_SITE` makes all staged changes live immediately\n- Always confirm with the user before executing these actions\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| List sites | `WEBFLOW_LIST_WEBFLOW_SITES` | (none) |\n| Get site info | `WEBFLOW_GET_SITE_INFO` | `site_id` |\n| Publish site | `WEBFLOW_PUBLISH_SITE` | `site_id`, `custom_domains` or `publish_to_webflow_subdomain` |\n| List collections | `WEBFLOW_LIST_COLLECTIONS` | `site_id` |\n| Get collection schema | `WEBFLOW_GET_COLLECTION` | `collection_id` |\n| List collection items | `WEBFLOW_LIST_COLLECTION_ITEMS` | `collection_id`, `limit`, `offset` |\n| Get collection item | `WEBFLOW_GET_COLLECTION_ITEM` | `collection_id`, `item_id` |\n| Create collection item | `WEBFLOW_CREATE_COLLECTION_ITEM` | `collection_id`, `field_data` |\n| Update collection item | `WEBFLOW_UPDATE_COLLECTION_ITEM` | `collection_id`, `item_id`, `fields` |\n| Delete collection item | `WEBFLOW_DELETE_COLLECTION_ITEM` | `collection_id`, `item_id` |\n| List pages | `WEBFLOW_LIST_PAGES` | `site_id`, `limit`, `offset` |\n| Get page | `WEBFLOW_GET_PAGE` | `page_id` |\n| Get page DOM | `WEBFLOW_GET_PAGE_DOM` | `page_id` |\n| Upload asset | `WEBFLOW_UPLOAD_ASSET` | `site_id`, `file_name`, `file_content`, `content_type`, `md5` |\n| List orders | `WEBFLOW_LIST_ORDERS` | `site_id`, `status` |\n| Get order | `WEBFLOW_GET_ORDER` | `site_id`, `order_id` |\n","repo_fullName":"mk-knight23/AGENTS-COLLECTION","repo_stars":69,"repo_language":"TypeScript","repo_license":null,"repo_pushedAt":"2026-04-16T07:24:00Z","owner_login":"mk-knight23","owner_type":"User","owner_name":"KAZI MUSHARRAF","owner_avatarUrl":"https://avatars.githubusercontent.com/u/71258852?v=4"}};