[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-automattic-adapt":3,"mdc-hwzjlp-key":36,"related-org-automattic-adapt":2869,"related-repo-automattic-adapt":3057},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"adapt","build platform adapters for content extraction","Build a new platform adapter to extract content from an unsupported platform (Blogger, Ghost, Tumblr, etc.)",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"automattic","Automattic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fautomattic.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Data Engineering","data-engineering","tag",{"name":17,"slug":18,"type":15},"Automation","automation",{"name":20,"slug":21,"type":15},"WordPress","wordpress",{"name":23,"slug":24,"type":15},"Data Cleaning","data-cleaning",31,"https:\u002F\u002Fgithub.com\u002FAutomattic\u002Fdata-liberation-agent","2026-05-09T05:32:13.987972",null,1,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"Extract content from closed web platforms into WordPress-compatible WXR files.","https:\u002F\u002Fgithub.com\u002FAutomattic\u002Fdata-liberation-agent\u002Ftree\u002FHEAD\u002Fskills\u002Fadapt","---\nname: adapt\ndescription: Build a new platform adapter to extract content from an unsupported platform (Blogger, Ghost, Tumblr, etc.)\nallowed-tools:\n - Bash\n - Read\n - Write\n - Edit\n - Glob\n - Grep\n - AskUserQuestion\n - WebSearch\n---\n\n# Adapt — Build a New Platform Adapter\n\nGuide the process of adding extraction support for a new platform. The result is a working adapter that plugs into the existing extraction pipeline.\n\n## Before You Start\n\n1. **Check if the platform is already supported.** Read `src\u002Fadapters\u002F` — if an adapter exists, this skill isn't needed.\n2. **Ask the user for a live site URL** on the target platform. You need a real site to reverse-engineer against.\n\n## Phase 1: Reconnaissance\n\nUnderstand how the target platform works before writing any code.\n\n### 1a. Platform Detection\n\nFigure out how to identify sites on this platform. Check:\n\n1. **URL patterns** — does the domain contain platform-specific strings? (e.g. `.squarespace.com`, `.webflow.io`, `.wixsite.com`)\n2. **HTTP headers** — fetch the site and look for platform-specific response headers (e.g. `X-Squarespace-Version`, `X-Wix-Request-Id`)\n3. **HTML markers** — look for platform-specific tags, classes, scripts, or meta tags in the page source\n4. **DNS** — check CNAME records that point to platform infrastructure\n\nAdd detection signals to `src\u002Flib\u002Fextraction\u002Fdetect-platform.ts`:\n- URL patterns go in `URL_PATTERNS`\n- HTTP\u002FHTML signals go in `detectFromHttp()`\n\n### 1b. Content Discovery\n\nFigure out how to find all pages on the site:\n\n1. **Sitemap** — try `sitemap.xml`, `sitemap_index.xml`. Most platforms generate these.\n2. **Navigation crawl** — the shared `extractNavLinks()` in `src\u002Fadapters\u002Fshared.ts` handles this generically.\n3. **Platform API** — some platforms have public APIs that list pages\u002Fposts (like Squarespace's `?format=json` or Shopify's `\u002Fproducts.json`).\n4. **Structured data** — check JSON-LD, Open Graph, and meta tags for content type hints.\n\n### 1c. Content Extraction\n\nFigure out how to get the actual content from each page:\n\n1. **API-first** — does the platform expose content via API\u002FJSON? This is always preferred.\n2. **HTML parsing** — if no API, parse the server-rendered HTML. Look for semantic containers (`.post-body`, `article`, `.content`, `main`).\n3. **Browser rendering** — if content is JavaScript-rendered, use Playwright via `launchBrowser()` from `src\u002Fadapters\u002Fshared.ts`.\n\n### 1d. API Mapping (recommended for complex platforms)\n\nIf the platform has an admin dashboard or uses client-side API calls, use `liberate_map_apis` to automatically discover all API endpoints:\n\n1. Ask the user to launch Chrome with `--remote-debugging-port=9222` and log in to their account on the target platform\n2. Call `liberate_map_apis` with the CDP port, the site URL, and optionally a list of admin dashboard URLs to crawl\n3. The tool navigates each URL, captures all JSON API traffic via CDP, and produces:\n - A categorized endpoint catalog (Content, Site Config, Auth, Commerce, Analytics, Media)\n - Sample request headers and response previews for each endpoint\n - Auth header patterns (X-*, Authorization, cookies) used by the platform\n - Query parameters observed on each endpoint\n\nThis is the fastest way to reverse-engineer a platform's API surface. The output tells you exactly which endpoints return content data, what auth is needed, and what the response shapes look like — everything you need to write the adapter's `extractPage` function.\n\nYou can also call `liberate_probe` to inspect window globals, localStorage, cookies, and platform identity fields on any page — useful for understanding what data the platform exposes client-side.\n\n**Document everything you find.** This is research — take notes on endpoints, selectors, quirks.\n\n## Phase 2: Build the Adapter\n\n### 2a. Scaffold\n\nAn adapter is a **directory** `src\u002Fadapters\u002F\u003Cplatform>\u002F`, never a single file. `index.ts` is a thin assembler; each concern lives in its own sibling. Read `src\u002Fadapters\u002Fwebflow\u002F` (the smallest — a 3-file split) and `src\u002Fadapters\u002Fshopify\u002F` (a fuller split) as references.\n\n**`index.ts` — thin assembler + public API.** It defines `detect` inline, imports `discover`\u002F`extract` (and optional `capture`\u002F`blocks`) from siblings, exports the `\u003Cplatform>Adapter` object, and **re-exports the inventory\u002Fopts types** (plus any helpers other modules need) so external code only ever imports `\u003Cplatform>\u002Findex.js`. Keep all real logic in siblings.\n\n```typescript\n\u002F\u002F src\u002Fadapters\u002Fwebflow\u002Findex.ts — the whole assembler\nimport type { PlatformAdapter } from '..\u002F..\u002Ftypes.js';\nimport { discoverWebflow } from '.\u002Fdiscover.js';\nimport { extractWebflow } from '.\u002Fextract.js';\n\nexport type { WebflowInventory, WebflowAdapterOpts } from '.\u002Fdiscover.js';\n\nfunction detect(url: string): boolean {\n return \u002Fwebflow\\.io|webflow\\.com\u002Fi.test(url);\n}\n\nexport const webflowAdapter: PlatformAdapter = {\n id: 'webflow',\n detect,\n discover: discoverWebflow,\n extract: extractWebflow,\n};\n```\n\n**Sibling files** — add only what the platform needs (webflow uses 3; richer platforms split further):\n\n| file | holds |\n|------|-------|\n| `types.ts` | `\u003CPlatform>AdapterOpts` + `\u003CPlatform>Inventory` (+ platform JSON shapes) |\n| `discover.ts` | `discover()` — sitemap\u002Fnav crawl, URL classification → inventory |\n| `extract.ts` | `extract()` — drives `runExtractionLoop()` with an `extractPage` fn |\n| `content.ts` | HTML\u002Fcontent parsing + quality scoring |\n| `media.ts` | media URL extraction |\n| `products.ts` | product → `WooProduct` mapping (e-commerce only) |\n| `capture.ts` | optional `AdapterCapture` (seam 1 — pre-capture DOM removals) |\n| `blocks.ts` | optional `AdapterBlocks` (seam 2 — content→blocks recipe) |\n\nBoth seams are typed in `src\u002Fadapters\u002Fpage-actions.ts`; examples are `shopify\u002Fcapture.ts` and `squarespace\u002Fblocks.ts`. Add any platform-specific helpers as further siblings (wix has `runtime.ts`\u002F`gallery.ts`\u002F`page.ts`; hubspot has `url.ts`\u002F`metadata.ts`). The tiny webflow adapter has no `types.ts` — it inlines its opts\u002Finventory in `discover.ts` and re-exports from there; use a dedicated `types.ts` for anything non-trivial.\n\n**The adapter contract** — `\u003Cplatform>Adapter` implements `PlatformAdapter` (`src\u002Ftypes.ts`):\n- **`id`** — lowercase platform name (e.g. `'ghost'`)\n- **`detect(url)`** — `true` if the URL belongs to this platform (defined inline in `index.ts`)\n- **`discover(url, opts)`** — fetch sitemap + navigation, classify URLs, return inventory\n- **`extract(inventory, wxr, opts, context)`** — call `runExtractionLoop()` from `src\u002Fadapters\u002Fshared.ts` with an `extractPage` function\n- optional **`probe`**, **`capture`**, **`blocks`**\n\nDefine in `types.ts`:\n- `\u003CPlatform>AdapterOpts` extending `Record\u003Cstring, unknown>` with: `delay?`, `resume?`, `dryRun?`, `verbose?`, `outputDir?`\n- `\u003CPlatform>Inventory` with: `siteUrl`, `discoveredAt`, `siteMeta` (title, tagline, language), `navigation`, `counts`, `urls`\n\n### 2b. The extractPage Function\n\nThis is where platform-specific extraction lives. For each URL:\n\n1. Fetch the page (via API or HTTP)\n2. Extract: title, slug, content (HTML), excerpt, date, seoTitle, seoDescription, mediaUrls\n3. Score quality using your own signals\n4. Return an `ExtractedPage` object (defined in `src\u002Fadapters\u002Fshared.ts`)\n\nUse the shared helpers from `src\u002Fadapters\u002Fshared.ts`:\n- `extractMeta(html, property)` — read meta tags\n- `extractTitle(html)` — read `\u003Ctitle>` tag\n- `extractHeading(html)` — read `\u003Ch1>` with title fallback\n- `extractNavLinks(html, baseUrl)` — parse nav links\n- `IMAGE_EXTENSIONS` — regex for image file detection\n\n### 2c. Product Support\n\nCheck during reconnaissance whether the platform has e-commerce (product pages, a store, a shop section).\n\n**Generic detection (automatic):** The shared extraction loop in `src\u002Fadapters\u002Fshared.ts` automatically detects products via JSON-LD `@type: Product` on any page classified as `product` type. This works out of the box if:\n- The platform emits JSON-LD Product schema\n- The sitemap or URL classifier marks product URLs correctly\n\n**Platform-specific detection (optional but recommended):** If the platform has a richer product API or non-standard product markup, provide a custom `extractProduct` function to `runExtractionLoop()`:\n\n```typescript\nconst result = await runExtractionLoop({\n \u002F\u002F ...other opts\n csvBuilder,\n extractProduct: (url: string, html: string) => {\n \u002F\u002F Try platform-specific product extraction first\n \u002F\u002F Return WooProduct or null\n },\n});\n```\n\nThe custom extractor is called before the generic JSON-LD fallback, so it takes priority.\n\n**What to extract for products** (see `WooProduct` type in `src\u002Flib\u002Fimport\u002Fwoo-product-csv.ts`):\n- `name` (required), `description`, `shortDescription`\n- `regularPrice`, `salePrice`\n- `sku`\n- `images` — array of image URLs\n- `categories`, `tags`\n- `weight`, `length`, `width`, `height`\n- `inStock`, `stock`\n- `attributes` — array of `{ name, values[], visible, global }` for product options (size, color, etc.)\n- `type` — `'simple'`, `'variable'`, `'grouped'`, `'external'`, or `'variation'`\n- `parentSku` — for variations, the parent product's SKU\n\n**Variable products:** If the platform supports product variants (sizes, colors), generate one `variable` parent row plus `variation` child rows with `parentSku` linking them. See `shopifyProductToWoo()` in `src\u002Fadapters\u002Fshopify\u002Fproducts.ts` for the pattern.\n\n**CSV streaming:** The adapter should create a `WooProductCsvBuilder`, call `openStream(outputDir)` before extraction, and `closeStream()` after. The shared loop calls `csvBuilder.addProduct()` automatically when it detects products. See the Shopify or Wix adapters for the wiring pattern.\n\n## Phase 3: Register\n\nAlways import the adapter from its barrel — `.\u002Fadapters\u002F\u003Cplatform>\u002Findex.js` — never a sibling directly.\n\n1. **`src\u002Fmcp-server.ts`** (required) — add the import under the `\u002F\u002F Static adapter imports` comment and add the adapter to the `adapters: PlatformAdapter[]` array. Both are kept **alphabetical**.\n2. **`src\u002Fui\u002Fdiscover.tsx`** (CLI\u002FInk discovery UI) — add the top-level import and append to its `adapters` array. The default `data-liberation \u003Curl>` flow resolves adapters here, so the CLI path needs it.\n3. **`src\u002Fui\u002Finspect.tsx`** (optional) — `liberate_inspect` lazy-`import()`s a small `allAdapters` list inside the component; add yours there for inspect coverage. This list is partial today and isn't required for extraction.\n\n## Phase 4: Test\n\n### 4a. Create Test Fixtures\n\nCreate fixture files in `test\u002Ffixtures\u002F` with sample HTML and\u002For JSON from the platform. Sanitize any PII.\n\n### 4b. Write Tests\n\nCreate `test\u002Fadapters\u002F\u003Cplatform>.test.ts`. Test:\n- Detection (URL patterns, HTML markers)\n- Page extraction (fixture HTML → ExtractedPage)\n- Media URL extraction\n- Content quality scoring\n- Product extraction (if the platform has e-commerce) — fixture product HTML → WooProduct with name, price, images, variants\n\n### 4c. Manual Verification\n\nRun extraction against the user's live site:\n```bash\nnpx tsx src\u002Fcli.ts \u003Csite-url> --dry-run --verbose\n```\n\nCheck the output for quality: are titles correct? Is content complete? Are media URLs captured?\n\n## Phase 5: Document\n\n1. Add the platform to the supported platforms list in `README.md`\n2. Add a discovery entry to `DISCOVERIES.md` documenting what you learned about the platform\n3. Update `AGENTS.md` if any non-obvious details are worth noting\n\n## Tips\n\n- **Start with the simplest extraction path.** Get basic pages working first, then add blog posts, then products, then edge cases.\n- **Check the existing adapters** for patterns you can reuse. Don't reinvent what shared.ts already provides.\n- **Platform APIs change.** Document the version\u002Fdate of any API you reverse-engineer.\n- **Test with both small and large sites.** A 5-page portfolio and a 500-page blog exercise different code paths.\n",{"data":37,"body":47},{"name":4,"description":6,"allowed-tools":38},[39,40,41,42,43,44,45,46],"Bash","Read","Write","Edit","Glob","Grep","AskUserQuestion","WebSearch",{"type":48,"children":49},"root",[50,59,65,72,107,113,118,125,130,210,223,249,255,260,350,356,361,437,443,456,512,525,538,548,554,560,604,681,1200,1210,1438,1525,1557,1686,1697,1803,1809,1814,1851,1862,1935,1941,1946,1979,1992,2016,2178,2183,2207,2407,2455,2497,2503,2516,2623,2629,2635,2648,2654,2667,2695,2701,2706,2763,2768,2774,2814,2820,2863],{"type":51,"tag":52,"props":53,"children":55},"element","h1",{"id":54},"adapt-build-a-new-platform-adapter",[56],{"type":57,"value":58},"text","Adapt — Build a New Platform Adapter",{"type":51,"tag":60,"props":61,"children":62},"p",{},[63],{"type":57,"value":64},"Guide the process of adding extraction support for a new platform. The result is a working adapter that plugs into the existing extraction pipeline.",{"type":51,"tag":66,"props":67,"children":69},"h2",{"id":68},"before-you-start",[70],{"type":57,"value":71},"Before You Start",{"type":51,"tag":73,"props":74,"children":75},"ol",{},[76,97],{"type":51,"tag":77,"props":78,"children":79},"li",{},[80,86,88,95],{"type":51,"tag":81,"props":82,"children":83},"strong",{},[84],{"type":57,"value":85},"Check if the platform is already supported.",{"type":57,"value":87}," Read ",{"type":51,"tag":89,"props":90,"children":92},"code",{"className":91},[],[93],{"type":57,"value":94},"src\u002Fadapters\u002F",{"type":57,"value":96}," — if an adapter exists, this skill isn't needed.",{"type":51,"tag":77,"props":98,"children":99},{},[100,105],{"type":51,"tag":81,"props":101,"children":102},{},[103],{"type":57,"value":104},"Ask the user for a live site URL",{"type":57,"value":106}," on the target platform. You need a real site to reverse-engineer against.",{"type":51,"tag":66,"props":108,"children":110},{"id":109},"phase-1-reconnaissance",[111],{"type":57,"value":112},"Phase 1: Reconnaissance",{"type":51,"tag":60,"props":114,"children":115},{},[116],{"type":57,"value":117},"Understand how the target platform works before writing any code.",{"type":51,"tag":119,"props":120,"children":122},"h3",{"id":121},"_1a-platform-detection",[123],{"type":57,"value":124},"1a. Platform Detection",{"type":51,"tag":60,"props":126,"children":127},{},[128],{"type":57,"value":129},"Figure out how to identify sites on this platform. Check:",{"type":51,"tag":73,"props":131,"children":132},{},[133,166,190,200],{"type":51,"tag":77,"props":134,"children":135},{},[136,141,143,149,151,157,158,164],{"type":51,"tag":81,"props":137,"children":138},{},[139],{"type":57,"value":140},"URL patterns",{"type":57,"value":142}," — does the domain contain platform-specific strings? (e.g. ",{"type":51,"tag":89,"props":144,"children":146},{"className":145},[],[147],{"type":57,"value":148},".squarespace.com",{"type":57,"value":150},", ",{"type":51,"tag":89,"props":152,"children":154},{"className":153},[],[155],{"type":57,"value":156},".webflow.io",{"type":57,"value":150},{"type":51,"tag":89,"props":159,"children":161},{"className":160},[],[162],{"type":57,"value":163},".wixsite.com",{"type":57,"value":165},")",{"type":51,"tag":77,"props":167,"children":168},{},[169,174,176,182,183,189],{"type":51,"tag":81,"props":170,"children":171},{},[172],{"type":57,"value":173},"HTTP headers",{"type":57,"value":175}," — fetch the site and look for platform-specific response headers (e.g. ",{"type":51,"tag":89,"props":177,"children":179},{"className":178},[],[180],{"type":57,"value":181},"X-Squarespace-Version",{"type":57,"value":150},{"type":51,"tag":89,"props":184,"children":186},{"className":185},[],[187],{"type":57,"value":188},"X-Wix-Request-Id",{"type":57,"value":165},{"type":51,"tag":77,"props":191,"children":192},{},[193,198],{"type":51,"tag":81,"props":194,"children":195},{},[196],{"type":57,"value":197},"HTML markers",{"type":57,"value":199}," — look for platform-specific tags, classes, scripts, or meta tags in the page source",{"type":51,"tag":77,"props":201,"children":202},{},[203,208],{"type":51,"tag":81,"props":204,"children":205},{},[206],{"type":57,"value":207},"DNS",{"type":57,"value":209}," — check CNAME records that point to platform infrastructure",{"type":51,"tag":60,"props":211,"children":212},{},[213,215,221],{"type":57,"value":214},"Add detection signals to ",{"type":51,"tag":89,"props":216,"children":218},{"className":217},[],[219],{"type":57,"value":220},"src\u002Flib\u002Fextraction\u002Fdetect-platform.ts",{"type":57,"value":222},":",{"type":51,"tag":224,"props":225,"children":226},"ul",{},[227,238],{"type":51,"tag":77,"props":228,"children":229},{},[230,232],{"type":57,"value":231},"URL patterns go in ",{"type":51,"tag":89,"props":233,"children":235},{"className":234},[],[236],{"type":57,"value":237},"URL_PATTERNS",{"type":51,"tag":77,"props":239,"children":240},{},[241,243],{"type":57,"value":242},"HTTP\u002FHTML signals go in ",{"type":51,"tag":89,"props":244,"children":246},{"className":245},[],[247],{"type":57,"value":248},"detectFromHttp()",{"type":51,"tag":119,"props":250,"children":252},{"id":251},"_1b-content-discovery",[253],{"type":57,"value":254},"1b. Content Discovery",{"type":51,"tag":60,"props":256,"children":257},{},[258],{"type":57,"value":259},"Figure out how to find all pages on the site:",{"type":51,"tag":73,"props":261,"children":262},{},[263,288,314,340],{"type":51,"tag":77,"props":264,"children":265},{},[266,271,273,279,280,286],{"type":51,"tag":81,"props":267,"children":268},{},[269],{"type":57,"value":270},"Sitemap",{"type":57,"value":272}," — try ",{"type":51,"tag":89,"props":274,"children":276},{"className":275},[],[277],{"type":57,"value":278},"sitemap.xml",{"type":57,"value":150},{"type":51,"tag":89,"props":281,"children":283},{"className":282},[],[284],{"type":57,"value":285},"sitemap_index.xml",{"type":57,"value":287},". Most platforms generate these.",{"type":51,"tag":77,"props":289,"children":290},{},[291,296,298,304,306,312],{"type":51,"tag":81,"props":292,"children":293},{},[294],{"type":57,"value":295},"Navigation crawl",{"type":57,"value":297}," — the shared ",{"type":51,"tag":89,"props":299,"children":301},{"className":300},[],[302],{"type":57,"value":303},"extractNavLinks()",{"type":57,"value":305}," in ",{"type":51,"tag":89,"props":307,"children":309},{"className":308},[],[310],{"type":57,"value":311},"src\u002Fadapters\u002Fshared.ts",{"type":57,"value":313}," handles this generically.",{"type":51,"tag":77,"props":315,"children":316},{},[317,322,324,330,332,338],{"type":51,"tag":81,"props":318,"children":319},{},[320],{"type":57,"value":321},"Platform API",{"type":57,"value":323}," — some platforms have public APIs that list pages\u002Fposts (like Squarespace's ",{"type":51,"tag":89,"props":325,"children":327},{"className":326},[],[328],{"type":57,"value":329},"?format=json",{"type":57,"value":331}," or Shopify's ",{"type":51,"tag":89,"props":333,"children":335},{"className":334},[],[336],{"type":57,"value":337},"\u002Fproducts.json",{"type":57,"value":339},").",{"type":51,"tag":77,"props":341,"children":342},{},[343,348],{"type":51,"tag":81,"props":344,"children":345},{},[346],{"type":57,"value":347},"Structured data",{"type":57,"value":349}," — check JSON-LD, Open Graph, and meta tags for content type hints.",{"type":51,"tag":119,"props":351,"children":353},{"id":352},"_1c-content-extraction",[354],{"type":57,"value":355},"1c. Content Extraction",{"type":51,"tag":60,"props":357,"children":358},{},[359],{"type":57,"value":360},"Figure out how to get the actual content from each page:",{"type":51,"tag":73,"props":362,"children":363},{},[364,374,412],{"type":51,"tag":77,"props":365,"children":366},{},[367,372],{"type":51,"tag":81,"props":368,"children":369},{},[370],{"type":57,"value":371},"API-first",{"type":57,"value":373}," — does the platform expose content via API\u002FJSON? This is always preferred.",{"type":51,"tag":77,"props":375,"children":376},{},[377,382,384,390,391,397,398,404,405,411],{"type":51,"tag":81,"props":378,"children":379},{},[380],{"type":57,"value":381},"HTML parsing",{"type":57,"value":383}," — if no API, parse the server-rendered HTML. Look for semantic containers (",{"type":51,"tag":89,"props":385,"children":387},{"className":386},[],[388],{"type":57,"value":389},".post-body",{"type":57,"value":150},{"type":51,"tag":89,"props":392,"children":394},{"className":393},[],[395],{"type":57,"value":396},"article",{"type":57,"value":150},{"type":51,"tag":89,"props":399,"children":401},{"className":400},[],[402],{"type":57,"value":403},".content",{"type":57,"value":150},{"type":51,"tag":89,"props":406,"children":408},{"className":407},[],[409],{"type":57,"value":410},"main",{"type":57,"value":339},{"type":51,"tag":77,"props":413,"children":414},{},[415,420,422,428,430,435],{"type":51,"tag":81,"props":416,"children":417},{},[418],{"type":57,"value":419},"Browser rendering",{"type":57,"value":421}," — if content is JavaScript-rendered, use Playwright via ",{"type":51,"tag":89,"props":423,"children":425},{"className":424},[],[426],{"type":57,"value":427},"launchBrowser()",{"type":57,"value":429}," from ",{"type":51,"tag":89,"props":431,"children":433},{"className":432},[],[434],{"type":57,"value":311},{"type":57,"value":436},".",{"type":51,"tag":119,"props":438,"children":440},{"id":439},"_1d-api-mapping-recommended-for-complex-platforms",[441],{"type":57,"value":442},"1d. API Mapping (recommended for complex platforms)",{"type":51,"tag":60,"props":444,"children":445},{},[446,448,454],{"type":57,"value":447},"If the platform has an admin dashboard or uses client-side API calls, use ",{"type":51,"tag":89,"props":449,"children":451},{"className":450},[],[452],{"type":57,"value":453},"liberate_map_apis",{"type":57,"value":455}," to automatically discover all API endpoints:",{"type":51,"tag":73,"props":457,"children":458},{},[459,472,484],{"type":51,"tag":77,"props":460,"children":461},{},[462,464,470],{"type":57,"value":463},"Ask the user to launch Chrome with ",{"type":51,"tag":89,"props":465,"children":467},{"className":466},[],[468],{"type":57,"value":469},"--remote-debugging-port=9222",{"type":57,"value":471}," and log in to their account on the target platform",{"type":51,"tag":77,"props":473,"children":474},{},[475,477,482],{"type":57,"value":476},"Call ",{"type":51,"tag":89,"props":478,"children":480},{"className":479},[],[481],{"type":57,"value":453},{"type":57,"value":483}," with the CDP port, the site URL, and optionally a list of admin dashboard URLs to crawl",{"type":51,"tag":77,"props":485,"children":486},{},[487,489],{"type":57,"value":488},"The tool navigates each URL, captures all JSON API traffic via CDP, and produces:\n",{"type":51,"tag":224,"props":490,"children":491},{},[492,497,502,507],{"type":51,"tag":77,"props":493,"children":494},{},[495],{"type":57,"value":496},"A categorized endpoint catalog (Content, Site Config, Auth, Commerce, Analytics, Media)",{"type":51,"tag":77,"props":498,"children":499},{},[500],{"type":57,"value":501},"Sample request headers and response previews for each endpoint",{"type":51,"tag":77,"props":503,"children":504},{},[505],{"type":57,"value":506},"Auth header patterns (X-*, Authorization, cookies) used by the platform",{"type":51,"tag":77,"props":508,"children":509},{},[510],{"type":57,"value":511},"Query parameters observed on each endpoint",{"type":51,"tag":60,"props":513,"children":514},{},[515,517,523],{"type":57,"value":516},"This is the fastest way to reverse-engineer a platform's API surface. The output tells you exactly which endpoints return content data, what auth is needed, and what the response shapes look like — everything you need to write the adapter's ",{"type":51,"tag":89,"props":518,"children":520},{"className":519},[],[521],{"type":57,"value":522},"extractPage",{"type":57,"value":524}," function.",{"type":51,"tag":60,"props":526,"children":527},{},[528,530,536],{"type":57,"value":529},"You can also call ",{"type":51,"tag":89,"props":531,"children":533},{"className":532},[],[534],{"type":57,"value":535},"liberate_probe",{"type":57,"value":537}," to inspect window globals, localStorage, cookies, and platform identity fields on any page — useful for understanding what data the platform exposes client-side.",{"type":51,"tag":60,"props":539,"children":540},{},[541,546],{"type":51,"tag":81,"props":542,"children":543},{},[544],{"type":57,"value":545},"Document everything you find.",{"type":57,"value":547}," This is research — take notes on endpoints, selectors, quirks.",{"type":51,"tag":66,"props":549,"children":551},{"id":550},"phase-2-build-the-adapter",[552],{"type":57,"value":553},"Phase 2: Build the Adapter",{"type":51,"tag":119,"props":555,"children":557},{"id":556},"_2a-scaffold",[558],{"type":57,"value":559},"2a. Scaffold",{"type":51,"tag":60,"props":561,"children":562},{},[563,565,570,572,578,580,586,588,594,596,602],{"type":57,"value":564},"An adapter is a ",{"type":51,"tag":81,"props":566,"children":567},{},[568],{"type":57,"value":569},"directory",{"type":57,"value":571}," ",{"type":51,"tag":89,"props":573,"children":575},{"className":574},[],[576],{"type":57,"value":577},"src\u002Fadapters\u002F\u003Cplatform>\u002F",{"type":57,"value":579},", never a single file. ",{"type":51,"tag":89,"props":581,"children":583},{"className":582},[],[584],{"type":57,"value":585},"index.ts",{"type":57,"value":587}," is a thin assembler; each concern lives in its own sibling. Read ",{"type":51,"tag":89,"props":589,"children":591},{"className":590},[],[592],{"type":57,"value":593},"src\u002Fadapters\u002Fwebflow\u002F",{"type":57,"value":595}," (the smallest — a 3-file split) and ",{"type":51,"tag":89,"props":597,"children":599},{"className":598},[],[600],{"type":57,"value":601},"src\u002Fadapters\u002Fshopify\u002F",{"type":57,"value":603}," (a fuller split) as references.",{"type":51,"tag":60,"props":605,"children":606},{},[607,617,619,625,627,633,635,641,643,649,650,656,658,664,666,671,673,679],{"type":51,"tag":81,"props":608,"children":609},{},[610,615],{"type":51,"tag":89,"props":611,"children":613},{"className":612},[],[614],{"type":57,"value":585},{"type":57,"value":616}," — thin assembler + public API.",{"type":57,"value":618}," It defines ",{"type":51,"tag":89,"props":620,"children":622},{"className":621},[],[623],{"type":57,"value":624},"detect",{"type":57,"value":626}," inline, imports ",{"type":51,"tag":89,"props":628,"children":630},{"className":629},[],[631],{"type":57,"value":632},"discover",{"type":57,"value":634},"\u002F",{"type":51,"tag":89,"props":636,"children":638},{"className":637},[],[639],{"type":57,"value":640},"extract",{"type":57,"value":642}," (and optional ",{"type":51,"tag":89,"props":644,"children":646},{"className":645},[],[647],{"type":57,"value":648},"capture",{"type":57,"value":634},{"type":51,"tag":89,"props":651,"children":653},{"className":652},[],[654],{"type":57,"value":655},"blocks",{"type":57,"value":657},") from siblings, exports the ",{"type":51,"tag":89,"props":659,"children":661},{"className":660},[],[662],{"type":57,"value":663},"\u003Cplatform>Adapter",{"type":57,"value":665}," object, and ",{"type":51,"tag":81,"props":667,"children":668},{},[669],{"type":57,"value":670},"re-exports the inventory\u002Fopts types",{"type":57,"value":672}," (plus any helpers other modules need) so external code only ever imports ",{"type":51,"tag":89,"props":674,"children":676},{"className":675},[],[677],{"type":57,"value":678},"\u003Cplatform>\u002Findex.js",{"type":57,"value":680},". Keep all real logic in siblings.",{"type":51,"tag":682,"props":683,"children":688},"pre",{"className":684,"code":685,"language":686,"meta":687,"style":687},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F src\u002Fadapters\u002Fwebflow\u002Findex.ts — the whole assembler\nimport type { PlatformAdapter } from '..\u002F..\u002Ftypes.js';\nimport { discoverWebflow } from '.\u002Fdiscover.js';\nimport { extractWebflow } from '.\u002Fextract.js';\n\nexport type { WebflowInventory, WebflowAdapterOpts } from '.\u002Fdiscover.js';\n\nfunction detect(url: string): boolean {\n return \u002Fwebflow\\.io|webflow\\.com\u002Fi.test(url);\n}\n\nexport const webflowAdapter: PlatformAdapter = {\n id: 'webflow',\n detect,\n discover: discoverWebflow,\n extract: extractWebflow,\n};\n","typescript","",[689],{"type":51,"tag":89,"props":690,"children":691},{"__ignoreMap":687},[692,703,761,803,845,855,911,919,971,1054,1063,1071,1106,1136,1149,1170,1191],{"type":51,"tag":693,"props":694,"children":696},"span",{"class":695,"line":29},"line",[697],{"type":51,"tag":693,"props":698,"children":700},{"style":699},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[701],{"type":57,"value":702},"\u002F\u002F src\u002Fadapters\u002Fwebflow\u002Findex.ts — the whole assembler\n",{"type":51,"tag":693,"props":704,"children":706},{"class":695,"line":705},2,[707,713,718,724,730,735,740,745,751,756],{"type":51,"tag":693,"props":708,"children":710},{"style":709},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[711],{"type":57,"value":712},"import",{"type":51,"tag":693,"props":714,"children":715},{"style":709},[716],{"type":57,"value":717}," type",{"type":51,"tag":693,"props":719,"children":721},{"style":720},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[722],{"type":57,"value":723}," {",{"type":51,"tag":693,"props":725,"children":727},{"style":726},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[728],{"type":57,"value":729}," PlatformAdapter",{"type":51,"tag":693,"props":731,"children":732},{"style":720},[733],{"type":57,"value":734}," }",{"type":51,"tag":693,"props":736,"children":737},{"style":709},[738],{"type":57,"value":739}," from",{"type":51,"tag":693,"props":741,"children":742},{"style":720},[743],{"type":57,"value":744}," '",{"type":51,"tag":693,"props":746,"children":748},{"style":747},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[749],{"type":57,"value":750},"..\u002F..\u002Ftypes.js",{"type":51,"tag":693,"props":752,"children":753},{"style":720},[754],{"type":57,"value":755},"'",{"type":51,"tag":693,"props":757,"children":758},{"style":720},[759],{"type":57,"value":760},";\n",{"type":51,"tag":693,"props":762,"children":764},{"class":695,"line":763},3,[765,769,773,778,782,786,790,795,799],{"type":51,"tag":693,"props":766,"children":767},{"style":709},[768],{"type":57,"value":712},{"type":51,"tag":693,"props":770,"children":771},{"style":720},[772],{"type":57,"value":723},{"type":51,"tag":693,"props":774,"children":775},{"style":726},[776],{"type":57,"value":777}," discoverWebflow",{"type":51,"tag":693,"props":779,"children":780},{"style":720},[781],{"type":57,"value":734},{"type":51,"tag":693,"props":783,"children":784},{"style":709},[785],{"type":57,"value":739},{"type":51,"tag":693,"props":787,"children":788},{"style":720},[789],{"type":57,"value":744},{"type":51,"tag":693,"props":791,"children":792},{"style":747},[793],{"type":57,"value":794},".\u002Fdiscover.js",{"type":51,"tag":693,"props":796,"children":797},{"style":720},[798],{"type":57,"value":755},{"type":51,"tag":693,"props":800,"children":801},{"style":720},[802],{"type":57,"value":760},{"type":51,"tag":693,"props":804,"children":806},{"class":695,"line":805},4,[807,811,815,820,824,828,832,837,841],{"type":51,"tag":693,"props":808,"children":809},{"style":709},[810],{"type":57,"value":712},{"type":51,"tag":693,"props":812,"children":813},{"style":720},[814],{"type":57,"value":723},{"type":51,"tag":693,"props":816,"children":817},{"style":726},[818],{"type":57,"value":819}," extractWebflow",{"type":51,"tag":693,"props":821,"children":822},{"style":720},[823],{"type":57,"value":734},{"type":51,"tag":693,"props":825,"children":826},{"style":709},[827],{"type":57,"value":739},{"type":51,"tag":693,"props":829,"children":830},{"style":720},[831],{"type":57,"value":744},{"type":51,"tag":693,"props":833,"children":834},{"style":747},[835],{"type":57,"value":836},".\u002Fextract.js",{"type":51,"tag":693,"props":838,"children":839},{"style":720},[840],{"type":57,"value":755},{"type":51,"tag":693,"props":842,"children":843},{"style":720},[844],{"type":57,"value":760},{"type":51,"tag":693,"props":846,"children":848},{"class":695,"line":847},5,[849],{"type":51,"tag":693,"props":850,"children":852},{"emptyLinePlaceholder":851},true,[853],{"type":57,"value":854},"\n",{"type":51,"tag":693,"props":856,"children":858},{"class":695,"line":857},6,[859,864,868,872,877,882,887,891,895,899,903,907],{"type":51,"tag":693,"props":860,"children":861},{"style":709},[862],{"type":57,"value":863},"export",{"type":51,"tag":693,"props":865,"children":866},{"style":709},[867],{"type":57,"value":717},{"type":51,"tag":693,"props":869,"children":870},{"style":720},[871],{"type":57,"value":723},{"type":51,"tag":693,"props":873,"children":874},{"style":726},[875],{"type":57,"value":876}," WebflowInventory",{"type":51,"tag":693,"props":878,"children":879},{"style":720},[880],{"type":57,"value":881},",",{"type":51,"tag":693,"props":883,"children":884},{"style":726},[885],{"type":57,"value":886}," WebflowAdapterOpts",{"type":51,"tag":693,"props":888,"children":889},{"style":720},[890],{"type":57,"value":734},{"type":51,"tag":693,"props":892,"children":893},{"style":709},[894],{"type":57,"value":739},{"type":51,"tag":693,"props":896,"children":897},{"style":720},[898],{"type":57,"value":744},{"type":51,"tag":693,"props":900,"children":901},{"style":747},[902],{"type":57,"value":794},{"type":51,"tag":693,"props":904,"children":905},{"style":720},[906],{"type":57,"value":755},{"type":51,"tag":693,"props":908,"children":909},{"style":720},[910],{"type":57,"value":760},{"type":51,"tag":693,"props":912,"children":914},{"class":695,"line":913},7,[915],{"type":51,"tag":693,"props":916,"children":917},{"emptyLinePlaceholder":851},[918],{"type":57,"value":854},{"type":51,"tag":693,"props":920,"children":922},{"class":695,"line":921},8,[923,929,935,940,946,950,956,961,966],{"type":51,"tag":693,"props":924,"children":926},{"style":925},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[927],{"type":57,"value":928},"function",{"type":51,"tag":693,"props":930,"children":932},{"style":931},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[933],{"type":57,"value":934}," detect",{"type":51,"tag":693,"props":936,"children":937},{"style":720},[938],{"type":57,"value":939},"(",{"type":51,"tag":693,"props":941,"children":943},{"style":942},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic",[944],{"type":57,"value":945},"url",{"type":51,"tag":693,"props":947,"children":948},{"style":720},[949],{"type":57,"value":222},{"type":51,"tag":693,"props":951,"children":953},{"style":952},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[954],{"type":57,"value":955}," string",{"type":51,"tag":693,"props":957,"children":958},{"style":720},[959],{"type":57,"value":960},"):",{"type":51,"tag":693,"props":962,"children":963},{"style":952},[964],{"type":57,"value":965}," boolean",{"type":51,"tag":693,"props":967,"children":968},{"style":720},[969],{"type":57,"value":970}," {\n",{"type":51,"tag":693,"props":972,"children":974},{"class":695,"line":973},9,[975,980,985,990,995,1000,1005,1009,1013,1018,1022,1028,1032,1037,1042,1046,1050],{"type":51,"tag":693,"props":976,"children":977},{"style":709},[978],{"type":57,"value":979}," return",{"type":51,"tag":693,"props":981,"children":982},{"style":720},[983],{"type":57,"value":984}," \u002F",{"type":51,"tag":693,"props":986,"children":987},{"style":747},[988],{"type":57,"value":989},"webflow",{"type":51,"tag":693,"props":991,"children":992},{"style":726},[993],{"type":57,"value":994},"\\.",{"type":51,"tag":693,"props":996,"children":997},{"style":747},[998],{"type":57,"value":999},"io",{"type":51,"tag":693,"props":1001,"children":1002},{"style":720},[1003],{"type":57,"value":1004},"|",{"type":51,"tag":693,"props":1006,"children":1007},{"style":747},[1008],{"type":57,"value":989},{"type":51,"tag":693,"props":1010,"children":1011},{"style":726},[1012],{"type":57,"value":994},{"type":51,"tag":693,"props":1014,"children":1015},{"style":747},[1016],{"type":57,"value":1017},"com",{"type":51,"tag":693,"props":1019,"children":1020},{"style":720},[1021],{"type":57,"value":634},{"type":51,"tag":693,"props":1023,"children":1025},{"style":1024},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1026],{"type":57,"value":1027},"i",{"type":51,"tag":693,"props":1029,"children":1030},{"style":720},[1031],{"type":57,"value":436},{"type":51,"tag":693,"props":1033,"children":1034},{"style":931},[1035],{"type":57,"value":1036},"test",{"type":51,"tag":693,"props":1038,"children":1040},{"style":1039},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[1041],{"type":57,"value":939},{"type":51,"tag":693,"props":1043,"children":1044},{"style":726},[1045],{"type":57,"value":945},{"type":51,"tag":693,"props":1047,"children":1048},{"style":1039},[1049],{"type":57,"value":165},{"type":51,"tag":693,"props":1051,"children":1052},{"style":720},[1053],{"type":57,"value":760},{"type":51,"tag":693,"props":1055,"children":1057},{"class":695,"line":1056},10,[1058],{"type":51,"tag":693,"props":1059,"children":1060},{"style":720},[1061],{"type":57,"value":1062},"}\n",{"type":51,"tag":693,"props":1064,"children":1066},{"class":695,"line":1065},11,[1067],{"type":51,"tag":693,"props":1068,"children":1069},{"emptyLinePlaceholder":851},[1070],{"type":57,"value":854},{"type":51,"tag":693,"props":1072,"children":1074},{"class":695,"line":1073},12,[1075,1079,1084,1089,1093,1097,1102],{"type":51,"tag":693,"props":1076,"children":1077},{"style":709},[1078],{"type":57,"value":863},{"type":51,"tag":693,"props":1080,"children":1081},{"style":925},[1082],{"type":57,"value":1083}," const",{"type":51,"tag":693,"props":1085,"children":1086},{"style":726},[1087],{"type":57,"value":1088}," webflowAdapter",{"type":51,"tag":693,"props":1090,"children":1091},{"style":720},[1092],{"type":57,"value":222},{"type":51,"tag":693,"props":1094,"children":1095},{"style":952},[1096],{"type":57,"value":729},{"type":51,"tag":693,"props":1098,"children":1099},{"style":720},[1100],{"type":57,"value":1101}," =",{"type":51,"tag":693,"props":1103,"children":1104},{"style":720},[1105],{"type":57,"value":970},{"type":51,"tag":693,"props":1107,"children":1109},{"class":695,"line":1108},13,[1110,1115,1119,1123,1127,1131],{"type":51,"tag":693,"props":1111,"children":1112},{"style":1039},[1113],{"type":57,"value":1114}," id",{"type":51,"tag":693,"props":1116,"children":1117},{"style":720},[1118],{"type":57,"value":222},{"type":51,"tag":693,"props":1120,"children":1121},{"style":720},[1122],{"type":57,"value":744},{"type":51,"tag":693,"props":1124,"children":1125},{"style":747},[1126],{"type":57,"value":989},{"type":51,"tag":693,"props":1128,"children":1129},{"style":720},[1130],{"type":57,"value":755},{"type":51,"tag":693,"props":1132,"children":1133},{"style":720},[1134],{"type":57,"value":1135},",\n",{"type":51,"tag":693,"props":1137,"children":1139},{"class":695,"line":1138},14,[1140,1145],{"type":51,"tag":693,"props":1141,"children":1142},{"style":726},[1143],{"type":57,"value":1144}," detect",{"type":51,"tag":693,"props":1146,"children":1147},{"style":720},[1148],{"type":57,"value":1135},{"type":51,"tag":693,"props":1150,"children":1152},{"class":695,"line":1151},15,[1153,1158,1162,1166],{"type":51,"tag":693,"props":1154,"children":1155},{"style":1039},[1156],{"type":57,"value":1157}," discover",{"type":51,"tag":693,"props":1159,"children":1160},{"style":720},[1161],{"type":57,"value":222},{"type":51,"tag":693,"props":1163,"children":1164},{"style":726},[1165],{"type":57,"value":777},{"type":51,"tag":693,"props":1167,"children":1168},{"style":720},[1169],{"type":57,"value":1135},{"type":51,"tag":693,"props":1171,"children":1173},{"class":695,"line":1172},16,[1174,1179,1183,1187],{"type":51,"tag":693,"props":1175,"children":1176},{"style":1039},[1177],{"type":57,"value":1178}," extract",{"type":51,"tag":693,"props":1180,"children":1181},{"style":720},[1182],{"type":57,"value":222},{"type":51,"tag":693,"props":1184,"children":1185},{"style":726},[1186],{"type":57,"value":819},{"type":51,"tag":693,"props":1188,"children":1189},{"style":720},[1190],{"type":57,"value":1135},{"type":51,"tag":693,"props":1192,"children":1194},{"class":695,"line":1193},17,[1195],{"type":51,"tag":693,"props":1196,"children":1197},{"style":720},[1198],{"type":57,"value":1199},"};\n",{"type":51,"tag":60,"props":1201,"children":1202},{},[1203,1208],{"type":51,"tag":81,"props":1204,"children":1205},{},[1206],{"type":57,"value":1207},"Sibling files",{"type":57,"value":1209}," — add only what the platform needs (webflow uses 3; richer platforms split further):",{"type":51,"tag":1211,"props":1212,"children":1213},"table",{},[1214,1233],{"type":51,"tag":1215,"props":1216,"children":1217},"thead",{},[1218],{"type":51,"tag":1219,"props":1220,"children":1221},"tr",{},[1222,1228],{"type":51,"tag":1223,"props":1224,"children":1225},"th",{},[1226],{"type":57,"value":1227},"file",{"type":51,"tag":1223,"props":1229,"children":1230},{},[1231],{"type":57,"value":1232},"holds",{"type":51,"tag":1234,"props":1235,"children":1236},"tbody",{},[1237,1269,1292,1330,1347,1364,1389,1414],{"type":51,"tag":1219,"props":1238,"children":1239},{},[1240,1250],{"type":51,"tag":1241,"props":1242,"children":1243},"td",{},[1244],{"type":51,"tag":89,"props":1245,"children":1247},{"className":1246},[],[1248],{"type":57,"value":1249},"types.ts",{"type":51,"tag":1241,"props":1251,"children":1252},{},[1253,1259,1261,1267],{"type":51,"tag":89,"props":1254,"children":1256},{"className":1255},[],[1257],{"type":57,"value":1258},"\u003CPlatform>AdapterOpts",{"type":57,"value":1260}," + ",{"type":51,"tag":89,"props":1262,"children":1264},{"className":1263},[],[1265],{"type":57,"value":1266},"\u003CPlatform>Inventory",{"type":57,"value":1268}," (+ platform JSON shapes)",{"type":51,"tag":1219,"props":1270,"children":1271},{},[1272,1281],{"type":51,"tag":1241,"props":1273,"children":1274},{},[1275],{"type":51,"tag":89,"props":1276,"children":1278},{"className":1277},[],[1279],{"type":57,"value":1280},"discover.ts",{"type":51,"tag":1241,"props":1282,"children":1283},{},[1284,1290],{"type":51,"tag":89,"props":1285,"children":1287},{"className":1286},[],[1288],{"type":57,"value":1289},"discover()",{"type":57,"value":1291}," — sitemap\u002Fnav crawl, URL classification → inventory",{"type":51,"tag":1219,"props":1293,"children":1294},{},[1295,1304],{"type":51,"tag":1241,"props":1296,"children":1297},{},[1298],{"type":51,"tag":89,"props":1299,"children":1301},{"className":1300},[],[1302],{"type":57,"value":1303},"extract.ts",{"type":51,"tag":1241,"props":1305,"children":1306},{},[1307,1313,1315,1321,1323,1328],{"type":51,"tag":89,"props":1308,"children":1310},{"className":1309},[],[1311],{"type":57,"value":1312},"extract()",{"type":57,"value":1314}," — drives ",{"type":51,"tag":89,"props":1316,"children":1318},{"className":1317},[],[1319],{"type":57,"value":1320},"runExtractionLoop()",{"type":57,"value":1322}," with an ",{"type":51,"tag":89,"props":1324,"children":1326},{"className":1325},[],[1327],{"type":57,"value":522},{"type":57,"value":1329}," fn",{"type":51,"tag":1219,"props":1331,"children":1332},{},[1333,1342],{"type":51,"tag":1241,"props":1334,"children":1335},{},[1336],{"type":51,"tag":89,"props":1337,"children":1339},{"className":1338},[],[1340],{"type":57,"value":1341},"content.ts",{"type":51,"tag":1241,"props":1343,"children":1344},{},[1345],{"type":57,"value":1346},"HTML\u002Fcontent parsing + quality scoring",{"type":51,"tag":1219,"props":1348,"children":1349},{},[1350,1359],{"type":51,"tag":1241,"props":1351,"children":1352},{},[1353],{"type":51,"tag":89,"props":1354,"children":1356},{"className":1355},[],[1357],{"type":57,"value":1358},"media.ts",{"type":51,"tag":1241,"props":1360,"children":1361},{},[1362],{"type":57,"value":1363},"media URL extraction",{"type":51,"tag":1219,"props":1365,"children":1366},{},[1367,1376],{"type":51,"tag":1241,"props":1368,"children":1369},{},[1370],{"type":51,"tag":89,"props":1371,"children":1373},{"className":1372},[],[1374],{"type":57,"value":1375},"products.ts",{"type":51,"tag":1241,"props":1377,"children":1378},{},[1379,1381,1387],{"type":57,"value":1380},"product → ",{"type":51,"tag":89,"props":1382,"children":1384},{"className":1383},[],[1385],{"type":57,"value":1386},"WooProduct",{"type":57,"value":1388}," mapping (e-commerce only)",{"type":51,"tag":1219,"props":1390,"children":1391},{},[1392,1401],{"type":51,"tag":1241,"props":1393,"children":1394},{},[1395],{"type":51,"tag":89,"props":1396,"children":1398},{"className":1397},[],[1399],{"type":57,"value":1400},"capture.ts",{"type":51,"tag":1241,"props":1402,"children":1403},{},[1404,1406,1412],{"type":57,"value":1405},"optional ",{"type":51,"tag":89,"props":1407,"children":1409},{"className":1408},[],[1410],{"type":57,"value":1411},"AdapterCapture",{"type":57,"value":1413}," (seam 1 — pre-capture DOM removals)",{"type":51,"tag":1219,"props":1415,"children":1416},{},[1417,1426],{"type":51,"tag":1241,"props":1418,"children":1419},{},[1420],{"type":51,"tag":89,"props":1421,"children":1423},{"className":1422},[],[1424],{"type":57,"value":1425},"blocks.ts",{"type":51,"tag":1241,"props":1427,"children":1428},{},[1429,1430,1436],{"type":57,"value":1405},{"type":51,"tag":89,"props":1431,"children":1433},{"className":1432},[],[1434],{"type":57,"value":1435},"AdapterBlocks",{"type":57,"value":1437}," (seam 2 — content→blocks recipe)",{"type":51,"tag":60,"props":1439,"children":1440},{},[1441,1443,1449,1451,1457,1459,1465,1467,1473,1474,1480,1481,1487,1489,1495,1496,1502,1504,1509,1511,1516,1518,1523],{"type":57,"value":1442},"Both seams are typed in ",{"type":51,"tag":89,"props":1444,"children":1446},{"className":1445},[],[1447],{"type":57,"value":1448},"src\u002Fadapters\u002Fpage-actions.ts",{"type":57,"value":1450},"; examples are ",{"type":51,"tag":89,"props":1452,"children":1454},{"className":1453},[],[1455],{"type":57,"value":1456},"shopify\u002Fcapture.ts",{"type":57,"value":1458}," and ",{"type":51,"tag":89,"props":1460,"children":1462},{"className":1461},[],[1463],{"type":57,"value":1464},"squarespace\u002Fblocks.ts",{"type":57,"value":1466},". Add any platform-specific helpers as further siblings (wix has ",{"type":51,"tag":89,"props":1468,"children":1470},{"className":1469},[],[1471],{"type":57,"value":1472},"runtime.ts",{"type":57,"value":634},{"type":51,"tag":89,"props":1475,"children":1477},{"className":1476},[],[1478],{"type":57,"value":1479},"gallery.ts",{"type":57,"value":634},{"type":51,"tag":89,"props":1482,"children":1484},{"className":1483},[],[1485],{"type":57,"value":1486},"page.ts",{"type":57,"value":1488},"; hubspot has ",{"type":51,"tag":89,"props":1490,"children":1492},{"className":1491},[],[1493],{"type":57,"value":1494},"url.ts",{"type":57,"value":634},{"type":51,"tag":89,"props":1497,"children":1499},{"className":1498},[],[1500],{"type":57,"value":1501},"metadata.ts",{"type":57,"value":1503},"). The tiny webflow adapter has no ",{"type":51,"tag":89,"props":1505,"children":1507},{"className":1506},[],[1508],{"type":57,"value":1249},{"type":57,"value":1510}," — it inlines its opts\u002Finventory in ",{"type":51,"tag":89,"props":1512,"children":1514},{"className":1513},[],[1515],{"type":57,"value":1280},{"type":57,"value":1517}," and re-exports from there; use a dedicated ",{"type":51,"tag":89,"props":1519,"children":1521},{"className":1520},[],[1522],{"type":57,"value":1249},{"type":57,"value":1524}," for anything non-trivial.",{"type":51,"tag":60,"props":1526,"children":1527},{},[1528,1533,1535,1540,1542,1548,1550,1556],{"type":51,"tag":81,"props":1529,"children":1530},{},[1531],{"type":57,"value":1532},"The adapter contract",{"type":57,"value":1534}," — ",{"type":51,"tag":89,"props":1536,"children":1538},{"className":1537},[],[1539],{"type":57,"value":663},{"type":57,"value":1541}," implements ",{"type":51,"tag":89,"props":1543,"children":1545},{"className":1544},[],[1546],{"type":57,"value":1547},"PlatformAdapter",{"type":57,"value":1549}," (",{"type":51,"tag":89,"props":1551,"children":1553},{"className":1552},[],[1554],{"type":57,"value":1555},"src\u002Ftypes.ts",{"type":57,"value":960},{"type":51,"tag":224,"props":1558,"children":1559},{},[1560,1581,1608,1622,1655],{"type":51,"tag":77,"props":1561,"children":1562},{},[1563,1572,1574,1580],{"type":51,"tag":81,"props":1564,"children":1565},{},[1566],{"type":51,"tag":89,"props":1567,"children":1569},{"className":1568},[],[1570],{"type":57,"value":1571},"id",{"type":57,"value":1573}," — lowercase platform name (e.g. ",{"type":51,"tag":89,"props":1575,"children":1577},{"className":1576},[],[1578],{"type":57,"value":1579},"'ghost'",{"type":57,"value":165},{"type":51,"tag":77,"props":1582,"children":1583},{},[1584,1593,1594,1600,1602,1607],{"type":51,"tag":81,"props":1585,"children":1586},{},[1587],{"type":51,"tag":89,"props":1588,"children":1590},{"className":1589},[],[1591],{"type":57,"value":1592},"detect(url)",{"type":57,"value":1534},{"type":51,"tag":89,"props":1595,"children":1597},{"className":1596},[],[1598],{"type":57,"value":1599},"true",{"type":57,"value":1601}," if the URL belongs to this platform (defined inline in ",{"type":51,"tag":89,"props":1603,"children":1605},{"className":1604},[],[1606],{"type":57,"value":585},{"type":57,"value":165},{"type":51,"tag":77,"props":1609,"children":1610},{},[1611,1620],{"type":51,"tag":81,"props":1612,"children":1613},{},[1614],{"type":51,"tag":89,"props":1615,"children":1617},{"className":1616},[],[1618],{"type":57,"value":1619},"discover(url, opts)",{"type":57,"value":1621}," — fetch sitemap + navigation, classify URLs, return inventory",{"type":51,"tag":77,"props":1623,"children":1624},{},[1625,1634,1636,1641,1642,1647,1648,1653],{"type":51,"tag":81,"props":1626,"children":1627},{},[1628],{"type":51,"tag":89,"props":1629,"children":1631},{"className":1630},[],[1632],{"type":57,"value":1633},"extract(inventory, wxr, opts, context)",{"type":57,"value":1635}," — call ",{"type":51,"tag":89,"props":1637,"children":1639},{"className":1638},[],[1640],{"type":57,"value":1320},{"type":57,"value":429},{"type":51,"tag":89,"props":1643,"children":1645},{"className":1644},[],[1646],{"type":57,"value":311},{"type":57,"value":1322},{"type":51,"tag":89,"props":1649,"children":1651},{"className":1650},[],[1652],{"type":57,"value":522},{"type":57,"value":1654}," function",{"type":51,"tag":77,"props":1656,"children":1657},{},[1658,1659,1668,1669,1677,1678],{"type":57,"value":1405},{"type":51,"tag":81,"props":1660,"children":1661},{},[1662],{"type":51,"tag":89,"props":1663,"children":1665},{"className":1664},[],[1666],{"type":57,"value":1667},"probe",{"type":57,"value":150},{"type":51,"tag":81,"props":1670,"children":1671},{},[1672],{"type":51,"tag":89,"props":1673,"children":1675},{"className":1674},[],[1676],{"type":57,"value":648},{"type":57,"value":150},{"type":51,"tag":81,"props":1679,"children":1680},{},[1681],{"type":51,"tag":89,"props":1682,"children":1684},{"className":1683},[],[1685],{"type":57,"value":655},{"type":51,"tag":60,"props":1687,"children":1688},{},[1689,1691,1696],{"type":57,"value":1690},"Define in ",{"type":51,"tag":89,"props":1692,"children":1694},{"className":1693},[],[1695],{"type":57,"value":1249},{"type":57,"value":222},{"type":51,"tag":224,"props":1698,"children":1699},{},[1700,1752],{"type":51,"tag":77,"props":1701,"children":1702},{},[1703,1708,1710,1716,1718,1724,1725,1731,1732,1738,1739,1745,1746],{"type":51,"tag":89,"props":1704,"children":1706},{"className":1705},[],[1707],{"type":57,"value":1258},{"type":57,"value":1709}," extending ",{"type":51,"tag":89,"props":1711,"children":1713},{"className":1712},[],[1714],{"type":57,"value":1715},"Record\u003Cstring, unknown>",{"type":57,"value":1717}," with: ",{"type":51,"tag":89,"props":1719,"children":1721},{"className":1720},[],[1722],{"type":57,"value":1723},"delay?",{"type":57,"value":150},{"type":51,"tag":89,"props":1726,"children":1728},{"className":1727},[],[1729],{"type":57,"value":1730},"resume?",{"type":57,"value":150},{"type":51,"tag":89,"props":1733,"children":1735},{"className":1734},[],[1736],{"type":57,"value":1737},"dryRun?",{"type":57,"value":150},{"type":51,"tag":89,"props":1740,"children":1742},{"className":1741},[],[1743],{"type":57,"value":1744},"verbose?",{"type":57,"value":150},{"type":51,"tag":89,"props":1747,"children":1749},{"className":1748},[],[1750],{"type":57,"value":1751},"outputDir?",{"type":51,"tag":77,"props":1753,"children":1754},{},[1755,1760,1761,1767,1768,1774,1775,1781,1783,1789,1790,1796,1797],{"type":51,"tag":89,"props":1756,"children":1758},{"className":1757},[],[1759],{"type":57,"value":1266},{"type":57,"value":1717},{"type":51,"tag":89,"props":1762,"children":1764},{"className":1763},[],[1765],{"type":57,"value":1766},"siteUrl",{"type":57,"value":150},{"type":51,"tag":89,"props":1769,"children":1771},{"className":1770},[],[1772],{"type":57,"value":1773},"discoveredAt",{"type":57,"value":150},{"type":51,"tag":89,"props":1776,"children":1778},{"className":1777},[],[1779],{"type":57,"value":1780},"siteMeta",{"type":57,"value":1782}," (title, tagline, language), ",{"type":51,"tag":89,"props":1784,"children":1786},{"className":1785},[],[1787],{"type":57,"value":1788},"navigation",{"type":57,"value":150},{"type":51,"tag":89,"props":1791,"children":1793},{"className":1792},[],[1794],{"type":57,"value":1795},"counts",{"type":57,"value":150},{"type":51,"tag":89,"props":1798,"children":1800},{"className":1799},[],[1801],{"type":57,"value":1802},"urls",{"type":51,"tag":119,"props":1804,"children":1806},{"id":1805},"_2b-the-extractpage-function",[1807],{"type":57,"value":1808},"2b. The extractPage Function",{"type":51,"tag":60,"props":1810,"children":1811},{},[1812],{"type":57,"value":1813},"This is where platform-specific extraction lives. For each URL:",{"type":51,"tag":73,"props":1815,"children":1816},{},[1817,1822,1827,1832],{"type":51,"tag":77,"props":1818,"children":1819},{},[1820],{"type":57,"value":1821},"Fetch the page (via API or HTTP)",{"type":51,"tag":77,"props":1823,"children":1824},{},[1825],{"type":57,"value":1826},"Extract: title, slug, content (HTML), excerpt, date, seoTitle, seoDescription, mediaUrls",{"type":51,"tag":77,"props":1828,"children":1829},{},[1830],{"type":57,"value":1831},"Score quality using your own signals",{"type":51,"tag":77,"props":1833,"children":1834},{},[1835,1837,1843,1845,1850],{"type":57,"value":1836},"Return an ",{"type":51,"tag":89,"props":1838,"children":1840},{"className":1839},[],[1841],{"type":57,"value":1842},"ExtractedPage",{"type":57,"value":1844}," object (defined in ",{"type":51,"tag":89,"props":1846,"children":1848},{"className":1847},[],[1849],{"type":57,"value":311},{"type":57,"value":165},{"type":51,"tag":60,"props":1852,"children":1853},{},[1854,1856,1861],{"type":57,"value":1855},"Use the shared helpers from ",{"type":51,"tag":89,"props":1857,"children":1859},{"className":1858},[],[1860],{"type":57,"value":311},{"type":57,"value":222},{"type":51,"tag":224,"props":1863,"children":1864},{},[1865,1876,1895,1913,1924],{"type":51,"tag":77,"props":1866,"children":1867},{},[1868,1874],{"type":51,"tag":89,"props":1869,"children":1871},{"className":1870},[],[1872],{"type":57,"value":1873},"extractMeta(html, property)",{"type":57,"value":1875}," — read meta tags",{"type":51,"tag":77,"props":1877,"children":1878},{},[1879,1885,1887,1893],{"type":51,"tag":89,"props":1880,"children":1882},{"className":1881},[],[1883],{"type":57,"value":1884},"extractTitle(html)",{"type":57,"value":1886}," — read ",{"type":51,"tag":89,"props":1888,"children":1890},{"className":1889},[],[1891],{"type":57,"value":1892},"\u003Ctitle>",{"type":57,"value":1894}," tag",{"type":51,"tag":77,"props":1896,"children":1897},{},[1898,1904,1905,1911],{"type":51,"tag":89,"props":1899,"children":1901},{"className":1900},[],[1902],{"type":57,"value":1903},"extractHeading(html)",{"type":57,"value":1886},{"type":51,"tag":89,"props":1906,"children":1908},{"className":1907},[],[1909],{"type":57,"value":1910},"\u003Ch1>",{"type":57,"value":1912}," with title fallback",{"type":51,"tag":77,"props":1914,"children":1915},{},[1916,1922],{"type":51,"tag":89,"props":1917,"children":1919},{"className":1918},[],[1920],{"type":57,"value":1921},"extractNavLinks(html, baseUrl)",{"type":57,"value":1923}," — parse nav links",{"type":51,"tag":77,"props":1925,"children":1926},{},[1927,1933],{"type":51,"tag":89,"props":1928,"children":1930},{"className":1929},[],[1931],{"type":57,"value":1932},"IMAGE_EXTENSIONS",{"type":57,"value":1934}," — regex for image file detection",{"type":51,"tag":119,"props":1936,"children":1938},{"id":1937},"_2c-product-support",[1939],{"type":57,"value":1940},"2c. Product Support",{"type":51,"tag":60,"props":1942,"children":1943},{},[1944],{"type":57,"value":1945},"Check during reconnaissance whether the platform has e-commerce (product pages, a store, a shop section).",{"type":51,"tag":60,"props":1947,"children":1948},{},[1949,1954,1956,1961,1963,1969,1971,1977],{"type":51,"tag":81,"props":1950,"children":1951},{},[1952],{"type":57,"value":1953},"Generic detection (automatic):",{"type":57,"value":1955}," The shared extraction loop in ",{"type":51,"tag":89,"props":1957,"children":1959},{"className":1958},[],[1960],{"type":57,"value":311},{"type":57,"value":1962}," automatically detects products via JSON-LD ",{"type":51,"tag":89,"props":1964,"children":1966},{"className":1965},[],[1967],{"type":57,"value":1968},"@type: Product",{"type":57,"value":1970}," on any page classified as ",{"type":51,"tag":89,"props":1972,"children":1974},{"className":1973},[],[1975],{"type":57,"value":1976},"product",{"type":57,"value":1978}," type. This works out of the box if:",{"type":51,"tag":224,"props":1980,"children":1981},{},[1982,1987],{"type":51,"tag":77,"props":1983,"children":1984},{},[1985],{"type":57,"value":1986},"The platform emits JSON-LD Product schema",{"type":51,"tag":77,"props":1988,"children":1989},{},[1990],{"type":57,"value":1991},"The sitemap or URL classifier marks product URLs correctly",{"type":51,"tag":60,"props":1993,"children":1994},{},[1995,2000,2002,2008,2010,2015],{"type":51,"tag":81,"props":1996,"children":1997},{},[1998],{"type":57,"value":1999},"Platform-specific detection (optional but recommended):",{"type":57,"value":2001}," If the platform has a richer product API or non-standard product markup, provide a custom ",{"type":51,"tag":89,"props":2003,"children":2005},{"className":2004},[],[2006],{"type":57,"value":2007},"extractProduct",{"type":57,"value":2009}," function to ",{"type":51,"tag":89,"props":2011,"children":2013},{"className":2012},[],[2014],{"type":57,"value":1320},{"type":57,"value":222},{"type":51,"tag":682,"props":2017,"children":2019},{"className":684,"code":2018,"language":686,"meta":687,"style":687},"const result = await runExtractionLoop({\n \u002F\u002F ...other opts\n csvBuilder,\n extractProduct: (url: string, html: string) => {\n \u002F\u002F Try platform-specific product extraction first\n \u002F\u002F Return WooProduct or null\n },\n});\n",[2020],{"type":51,"tag":89,"props":2021,"children":2022},{"__ignoreMap":687},[2023,2060,2068,2080,2138,2146,2154,2162],{"type":51,"tag":693,"props":2024,"children":2025},{"class":695,"line":29},[2026,2031,2036,2041,2046,2051,2055],{"type":51,"tag":693,"props":2027,"children":2028},{"style":925},[2029],{"type":57,"value":2030},"const",{"type":51,"tag":693,"props":2032,"children":2033},{"style":726},[2034],{"type":57,"value":2035}," result ",{"type":51,"tag":693,"props":2037,"children":2038},{"style":720},[2039],{"type":57,"value":2040},"=",{"type":51,"tag":693,"props":2042,"children":2043},{"style":709},[2044],{"type":57,"value":2045}," await",{"type":51,"tag":693,"props":2047,"children":2048},{"style":931},[2049],{"type":57,"value":2050}," runExtractionLoop",{"type":51,"tag":693,"props":2052,"children":2053},{"style":726},[2054],{"type":57,"value":939},{"type":51,"tag":693,"props":2056,"children":2057},{"style":720},[2058],{"type":57,"value":2059},"{\n",{"type":51,"tag":693,"props":2061,"children":2062},{"class":695,"line":705},[2063],{"type":51,"tag":693,"props":2064,"children":2065},{"style":699},[2066],{"type":57,"value":2067}," \u002F\u002F ...other opts\n",{"type":51,"tag":693,"props":2069,"children":2070},{"class":695,"line":763},[2071,2076],{"type":51,"tag":693,"props":2072,"children":2073},{"style":726},[2074],{"type":57,"value":2075}," csvBuilder",{"type":51,"tag":693,"props":2077,"children":2078},{"style":720},[2079],{"type":57,"value":1135},{"type":51,"tag":693,"props":2081,"children":2082},{"class":695,"line":805},[2083,2088,2092,2096,2100,2104,2108,2112,2117,2121,2125,2129,2134],{"type":51,"tag":693,"props":2084,"children":2085},{"style":931},[2086],{"type":57,"value":2087}," extractProduct",{"type":51,"tag":693,"props":2089,"children":2090},{"style":720},[2091],{"type":57,"value":222},{"type":51,"tag":693,"props":2093,"children":2094},{"style":720},[2095],{"type":57,"value":1549},{"type":51,"tag":693,"props":2097,"children":2098},{"style":942},[2099],{"type":57,"value":945},{"type":51,"tag":693,"props":2101,"children":2102},{"style":720},[2103],{"type":57,"value":222},{"type":51,"tag":693,"props":2105,"children":2106},{"style":952},[2107],{"type":57,"value":955},{"type":51,"tag":693,"props":2109,"children":2110},{"style":720},[2111],{"type":57,"value":881},{"type":51,"tag":693,"props":2113,"children":2114},{"style":942},[2115],{"type":57,"value":2116}," html",{"type":51,"tag":693,"props":2118,"children":2119},{"style":720},[2120],{"type":57,"value":222},{"type":51,"tag":693,"props":2122,"children":2123},{"style":952},[2124],{"type":57,"value":955},{"type":51,"tag":693,"props":2126,"children":2127},{"style":720},[2128],{"type":57,"value":165},{"type":51,"tag":693,"props":2130,"children":2131},{"style":925},[2132],{"type":57,"value":2133}," =>",{"type":51,"tag":693,"props":2135,"children":2136},{"style":720},[2137],{"type":57,"value":970},{"type":51,"tag":693,"props":2139,"children":2140},{"class":695,"line":847},[2141],{"type":51,"tag":693,"props":2142,"children":2143},{"style":699},[2144],{"type":57,"value":2145}," \u002F\u002F Try platform-specific product extraction first\n",{"type":51,"tag":693,"props":2147,"children":2148},{"class":695,"line":857},[2149],{"type":51,"tag":693,"props":2150,"children":2151},{"style":699},[2152],{"type":57,"value":2153}," \u002F\u002F Return WooProduct or null\n",{"type":51,"tag":693,"props":2155,"children":2156},{"class":695,"line":913},[2157],{"type":51,"tag":693,"props":2158,"children":2159},{"style":720},[2160],{"type":57,"value":2161}," },\n",{"type":51,"tag":693,"props":2163,"children":2164},{"class":695,"line":921},[2165,2170,2174],{"type":51,"tag":693,"props":2166,"children":2167},{"style":720},[2168],{"type":57,"value":2169},"}",{"type":51,"tag":693,"props":2171,"children":2172},{"style":726},[2173],{"type":57,"value":165},{"type":51,"tag":693,"props":2175,"children":2176},{"style":720},[2177],{"type":57,"value":760},{"type":51,"tag":60,"props":2179,"children":2180},{},[2181],{"type":57,"value":2182},"The custom extractor is called before the generic JSON-LD fallback, so it takes priority.",{"type":51,"tag":60,"props":2184,"children":2185},{},[2186,2191,2193,2198,2200,2206],{"type":51,"tag":81,"props":2187,"children":2188},{},[2189],{"type":57,"value":2190},"What to extract for products",{"type":57,"value":2192}," (see ",{"type":51,"tag":89,"props":2194,"children":2196},{"className":2195},[],[2197],{"type":57,"value":1386},{"type":57,"value":2199}," type in ",{"type":51,"tag":89,"props":2201,"children":2203},{"className":2202},[],[2204],{"type":57,"value":2205},"src\u002Flib\u002Fimport\u002Fwoo-product-csv.ts",{"type":57,"value":960},{"type":51,"tag":224,"props":2208,"children":2209},{},[2210,2234,2250,2259,2270,2286,2316,2332,2351,2396],{"type":51,"tag":77,"props":2211,"children":2212},{},[2213,2219,2221,2227,2228],{"type":51,"tag":89,"props":2214,"children":2216},{"className":2215},[],[2217],{"type":57,"value":2218},"name",{"type":57,"value":2220}," (required), ",{"type":51,"tag":89,"props":2222,"children":2224},{"className":2223},[],[2225],{"type":57,"value":2226},"description",{"type":57,"value":150},{"type":51,"tag":89,"props":2229,"children":2231},{"className":2230},[],[2232],{"type":57,"value":2233},"shortDescription",{"type":51,"tag":77,"props":2235,"children":2236},{},[2237,2243,2244],{"type":51,"tag":89,"props":2238,"children":2240},{"className":2239},[],[2241],{"type":57,"value":2242},"regularPrice",{"type":57,"value":150},{"type":51,"tag":89,"props":2245,"children":2247},{"className":2246},[],[2248],{"type":57,"value":2249},"salePrice",{"type":51,"tag":77,"props":2251,"children":2252},{},[2253],{"type":51,"tag":89,"props":2254,"children":2256},{"className":2255},[],[2257],{"type":57,"value":2258},"sku",{"type":51,"tag":77,"props":2260,"children":2261},{},[2262,2268],{"type":51,"tag":89,"props":2263,"children":2265},{"className":2264},[],[2266],{"type":57,"value":2267},"images",{"type":57,"value":2269}," — array of image URLs",{"type":51,"tag":77,"props":2271,"children":2272},{},[2273,2279,2280],{"type":51,"tag":89,"props":2274,"children":2276},{"className":2275},[],[2277],{"type":57,"value":2278},"categories",{"type":57,"value":150},{"type":51,"tag":89,"props":2281,"children":2283},{"className":2282},[],[2284],{"type":57,"value":2285},"tags",{"type":51,"tag":77,"props":2287,"children":2288},{},[2289,2295,2296,2302,2303,2309,2310],{"type":51,"tag":89,"props":2290,"children":2292},{"className":2291},[],[2293],{"type":57,"value":2294},"weight",{"type":57,"value":150},{"type":51,"tag":89,"props":2297,"children":2299},{"className":2298},[],[2300],{"type":57,"value":2301},"length",{"type":57,"value":150},{"type":51,"tag":89,"props":2304,"children":2306},{"className":2305},[],[2307],{"type":57,"value":2308},"width",{"type":57,"value":150},{"type":51,"tag":89,"props":2311,"children":2313},{"className":2312},[],[2314],{"type":57,"value":2315},"height",{"type":51,"tag":77,"props":2317,"children":2318},{},[2319,2325,2326],{"type":51,"tag":89,"props":2320,"children":2322},{"className":2321},[],[2323],{"type":57,"value":2324},"inStock",{"type":57,"value":150},{"type":51,"tag":89,"props":2327,"children":2329},{"className":2328},[],[2330],{"type":57,"value":2331},"stock",{"type":51,"tag":77,"props":2333,"children":2334},{},[2335,2341,2343,2349],{"type":51,"tag":89,"props":2336,"children":2338},{"className":2337},[],[2339],{"type":57,"value":2340},"attributes",{"type":57,"value":2342}," — array of ",{"type":51,"tag":89,"props":2344,"children":2346},{"className":2345},[],[2347],{"type":57,"value":2348},"{ name, values[], visible, global }",{"type":57,"value":2350}," for product options (size, color, etc.)",{"type":51,"tag":77,"props":2352,"children":2353},{},[2354,2360,2361,2367,2368,2374,2375,2381,2382,2388,2390],{"type":51,"tag":89,"props":2355,"children":2357},{"className":2356},[],[2358],{"type":57,"value":2359},"type",{"type":57,"value":1534},{"type":51,"tag":89,"props":2362,"children":2364},{"className":2363},[],[2365],{"type":57,"value":2366},"'simple'",{"type":57,"value":150},{"type":51,"tag":89,"props":2369,"children":2371},{"className":2370},[],[2372],{"type":57,"value":2373},"'variable'",{"type":57,"value":150},{"type":51,"tag":89,"props":2376,"children":2378},{"className":2377},[],[2379],{"type":57,"value":2380},"'grouped'",{"type":57,"value":150},{"type":51,"tag":89,"props":2383,"children":2385},{"className":2384},[],[2386],{"type":57,"value":2387},"'external'",{"type":57,"value":2389},", or ",{"type":51,"tag":89,"props":2391,"children":2393},{"className":2392},[],[2394],{"type":57,"value":2395},"'variation'",{"type":51,"tag":77,"props":2397,"children":2398},{},[2399,2405],{"type":51,"tag":89,"props":2400,"children":2402},{"className":2401},[],[2403],{"type":57,"value":2404},"parentSku",{"type":57,"value":2406}," — for variations, the parent product's SKU",{"type":51,"tag":60,"props":2408,"children":2409},{},[2410,2415,2417,2423,2425,2431,2433,2438,2440,2446,2447,2453],{"type":51,"tag":81,"props":2411,"children":2412},{},[2413],{"type":57,"value":2414},"Variable products:",{"type":57,"value":2416}," If the platform supports product variants (sizes, colors), generate one ",{"type":51,"tag":89,"props":2418,"children":2420},{"className":2419},[],[2421],{"type":57,"value":2422},"variable",{"type":57,"value":2424}," parent row plus ",{"type":51,"tag":89,"props":2426,"children":2428},{"className":2427},[],[2429],{"type":57,"value":2430},"variation",{"type":57,"value":2432}," child rows with ",{"type":51,"tag":89,"props":2434,"children":2436},{"className":2435},[],[2437],{"type":57,"value":2404},{"type":57,"value":2439}," linking them. See ",{"type":51,"tag":89,"props":2441,"children":2443},{"className":2442},[],[2444],{"type":57,"value":2445},"shopifyProductToWoo()",{"type":57,"value":305},{"type":51,"tag":89,"props":2448,"children":2450},{"className":2449},[],[2451],{"type":57,"value":2452},"src\u002Fadapters\u002Fshopify\u002Fproducts.ts",{"type":57,"value":2454}," for the pattern.",{"type":51,"tag":60,"props":2456,"children":2457},{},[2458,2463,2465,2471,2473,2479,2481,2487,2489,2495],{"type":51,"tag":81,"props":2459,"children":2460},{},[2461],{"type":57,"value":2462},"CSV streaming:",{"type":57,"value":2464}," The adapter should create a ",{"type":51,"tag":89,"props":2466,"children":2468},{"className":2467},[],[2469],{"type":57,"value":2470},"WooProductCsvBuilder",{"type":57,"value":2472},", call ",{"type":51,"tag":89,"props":2474,"children":2476},{"className":2475},[],[2477],{"type":57,"value":2478},"openStream(outputDir)",{"type":57,"value":2480}," before extraction, and ",{"type":51,"tag":89,"props":2482,"children":2484},{"className":2483},[],[2485],{"type":57,"value":2486},"closeStream()",{"type":57,"value":2488}," after. The shared loop calls ",{"type":51,"tag":89,"props":2490,"children":2492},{"className":2491},[],[2493],{"type":57,"value":2494},"csvBuilder.addProduct()",{"type":57,"value":2496}," automatically when it detects products. See the Shopify or Wix adapters for the wiring pattern.",{"type":51,"tag":66,"props":2498,"children":2500},{"id":2499},"phase-3-register",[2501],{"type":57,"value":2502},"Phase 3: Register",{"type":51,"tag":60,"props":2504,"children":2505},{},[2506,2508,2514],{"type":57,"value":2507},"Always import the adapter from its barrel — ",{"type":51,"tag":89,"props":2509,"children":2511},{"className":2510},[],[2512],{"type":57,"value":2513},".\u002Fadapters\u002F\u003Cplatform>\u002Findex.js",{"type":57,"value":2515}," — never a sibling directly.",{"type":51,"tag":73,"props":2517,"children":2518},{},[2519,2555,2585],{"type":51,"tag":77,"props":2520,"children":2521},{},[2522,2531,2533,2539,2541,2547,2549,2554],{"type":51,"tag":81,"props":2523,"children":2524},{},[2525],{"type":51,"tag":89,"props":2526,"children":2528},{"className":2527},[],[2529],{"type":57,"value":2530},"src\u002Fmcp-server.ts",{"type":57,"value":2532}," (required) — add the import under the ",{"type":51,"tag":89,"props":2534,"children":2536},{"className":2535},[],[2537],{"type":57,"value":2538},"\u002F\u002F Static adapter imports",{"type":57,"value":2540}," comment and add the adapter to the ",{"type":51,"tag":89,"props":2542,"children":2544},{"className":2543},[],[2545],{"type":57,"value":2546},"adapters: PlatformAdapter[]",{"type":57,"value":2548}," array. Both are kept ",{"type":51,"tag":81,"props":2550,"children":2551},{},[2552],{"type":57,"value":2553},"alphabetical",{"type":57,"value":436},{"type":51,"tag":77,"props":2556,"children":2557},{},[2558,2567,2569,2575,2577,2583],{"type":51,"tag":81,"props":2559,"children":2560},{},[2561],{"type":51,"tag":89,"props":2562,"children":2564},{"className":2563},[],[2565],{"type":57,"value":2566},"src\u002Fui\u002Fdiscover.tsx",{"type":57,"value":2568}," (CLI\u002FInk discovery UI) — add the top-level import and append to its ",{"type":51,"tag":89,"props":2570,"children":2572},{"className":2571},[],[2573],{"type":57,"value":2574},"adapters",{"type":57,"value":2576}," array. The default ",{"type":51,"tag":89,"props":2578,"children":2580},{"className":2579},[],[2581],{"type":57,"value":2582},"data-liberation \u003Curl>",{"type":57,"value":2584}," flow resolves adapters here, so the CLI path needs it.",{"type":51,"tag":77,"props":2586,"children":2587},{},[2588,2597,2599,2605,2607,2613,2615,2621],{"type":51,"tag":81,"props":2589,"children":2590},{},[2591],{"type":51,"tag":89,"props":2592,"children":2594},{"className":2593},[],[2595],{"type":57,"value":2596},"src\u002Fui\u002Finspect.tsx",{"type":57,"value":2598}," (optional) — ",{"type":51,"tag":89,"props":2600,"children":2602},{"className":2601},[],[2603],{"type":57,"value":2604},"liberate_inspect",{"type":57,"value":2606}," lazy-",{"type":51,"tag":89,"props":2608,"children":2610},{"className":2609},[],[2611],{"type":57,"value":2612},"import()",{"type":57,"value":2614},"s a small ",{"type":51,"tag":89,"props":2616,"children":2618},{"className":2617},[],[2619],{"type":57,"value":2620},"allAdapters",{"type":57,"value":2622}," list inside the component; add yours there for inspect coverage. This list is partial today and isn't required for extraction.",{"type":51,"tag":66,"props":2624,"children":2626},{"id":2625},"phase-4-test",[2627],{"type":57,"value":2628},"Phase 4: Test",{"type":51,"tag":119,"props":2630,"children":2632},{"id":2631},"_4a-create-test-fixtures",[2633],{"type":57,"value":2634},"4a. Create Test Fixtures",{"type":51,"tag":60,"props":2636,"children":2637},{},[2638,2640,2646],{"type":57,"value":2639},"Create fixture files in ",{"type":51,"tag":89,"props":2641,"children":2643},{"className":2642},[],[2644],{"type":57,"value":2645},"test\u002Ffixtures\u002F",{"type":57,"value":2647}," with sample HTML and\u002For JSON from the platform. Sanitize any PII.",{"type":51,"tag":119,"props":2649,"children":2651},{"id":2650},"_4b-write-tests",[2652],{"type":57,"value":2653},"4b. Write Tests",{"type":51,"tag":60,"props":2655,"children":2656},{},[2657,2659,2665],{"type":57,"value":2658},"Create ",{"type":51,"tag":89,"props":2660,"children":2662},{"className":2661},[],[2663],{"type":57,"value":2664},"test\u002Fadapters\u002F\u003Cplatform>.test.ts",{"type":57,"value":2666},". Test:",{"type":51,"tag":224,"props":2668,"children":2669},{},[2670,2675,2680,2685,2690],{"type":51,"tag":77,"props":2671,"children":2672},{},[2673],{"type":57,"value":2674},"Detection (URL patterns, HTML markers)",{"type":51,"tag":77,"props":2676,"children":2677},{},[2678],{"type":57,"value":2679},"Page extraction (fixture HTML → ExtractedPage)",{"type":51,"tag":77,"props":2681,"children":2682},{},[2683],{"type":57,"value":2684},"Media URL extraction",{"type":51,"tag":77,"props":2686,"children":2687},{},[2688],{"type":57,"value":2689},"Content quality scoring",{"type":51,"tag":77,"props":2691,"children":2692},{},[2693],{"type":57,"value":2694},"Product extraction (if the platform has e-commerce) — fixture product HTML → WooProduct with name, price, images, variants",{"type":51,"tag":119,"props":2696,"children":2698},{"id":2697},"_4c-manual-verification",[2699],{"type":57,"value":2700},"4c. Manual Verification",{"type":51,"tag":60,"props":2702,"children":2703},{},[2704],{"type":57,"value":2705},"Run extraction against the user's live site:",{"type":51,"tag":682,"props":2707,"children":2711},{"className":2708,"code":2709,"language":2710,"meta":687,"style":687},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npx tsx src\u002Fcli.ts \u003Csite-url> --dry-run --verbose\n","bash",[2712],{"type":51,"tag":89,"props":2713,"children":2714},{"__ignoreMap":687},[2715],{"type":51,"tag":693,"props":2716,"children":2717},{"class":695,"line":29},[2718,2723,2728,2733,2738,2743,2748,2753,2758],{"type":51,"tag":693,"props":2719,"children":2720},{"style":952},[2721],{"type":57,"value":2722},"npx",{"type":51,"tag":693,"props":2724,"children":2725},{"style":747},[2726],{"type":57,"value":2727}," tsx",{"type":51,"tag":693,"props":2729,"children":2730},{"style":747},[2731],{"type":57,"value":2732}," src\u002Fcli.ts",{"type":51,"tag":693,"props":2734,"children":2735},{"style":720},[2736],{"type":57,"value":2737}," \u003C",{"type":51,"tag":693,"props":2739,"children":2740},{"style":747},[2741],{"type":57,"value":2742},"site-ur",{"type":51,"tag":693,"props":2744,"children":2745},{"style":726},[2746],{"type":57,"value":2747},"l",{"type":51,"tag":693,"props":2749,"children":2750},{"style":720},[2751],{"type":57,"value":2752},">",{"type":51,"tag":693,"props":2754,"children":2755},{"style":747},[2756],{"type":57,"value":2757}," --dry-run",{"type":51,"tag":693,"props":2759,"children":2760},{"style":747},[2761],{"type":57,"value":2762}," --verbose\n",{"type":51,"tag":60,"props":2764,"children":2765},{},[2766],{"type":57,"value":2767},"Check the output for quality: are titles correct? Is content complete? Are media URLs captured?",{"type":51,"tag":66,"props":2769,"children":2771},{"id":2770},"phase-5-document",[2772],{"type":57,"value":2773},"Phase 5: Document",{"type":51,"tag":73,"props":2775,"children":2776},{},[2777,2788,2801],{"type":51,"tag":77,"props":2778,"children":2779},{},[2780,2782],{"type":57,"value":2781},"Add the platform to the supported platforms list in ",{"type":51,"tag":89,"props":2783,"children":2785},{"className":2784},[],[2786],{"type":57,"value":2787},"README.md",{"type":51,"tag":77,"props":2789,"children":2790},{},[2791,2793,2799],{"type":57,"value":2792},"Add a discovery entry to ",{"type":51,"tag":89,"props":2794,"children":2796},{"className":2795},[],[2797],{"type":57,"value":2798},"DISCOVERIES.md",{"type":57,"value":2800}," documenting what you learned about the platform",{"type":51,"tag":77,"props":2802,"children":2803},{},[2804,2806,2812],{"type":57,"value":2805},"Update ",{"type":51,"tag":89,"props":2807,"children":2809},{"className":2808},[],[2810],{"type":57,"value":2811},"AGENTS.md",{"type":57,"value":2813}," if any non-obvious details are worth noting",{"type":51,"tag":66,"props":2815,"children":2817},{"id":2816},"tips",[2818],{"type":57,"value":2819},"Tips",{"type":51,"tag":224,"props":2821,"children":2822},{},[2823,2833,2843,2853],{"type":51,"tag":77,"props":2824,"children":2825},{},[2826,2831],{"type":51,"tag":81,"props":2827,"children":2828},{},[2829],{"type":57,"value":2830},"Start with the simplest extraction path.",{"type":57,"value":2832}," Get basic pages working first, then add blog posts, then products, then edge cases.",{"type":51,"tag":77,"props":2834,"children":2835},{},[2836,2841],{"type":51,"tag":81,"props":2837,"children":2838},{},[2839],{"type":57,"value":2840},"Check the existing adapters",{"type":57,"value":2842}," for patterns you can reuse. Don't reinvent what shared.ts already provides.",{"type":51,"tag":77,"props":2844,"children":2845},{},[2846,2851],{"type":51,"tag":81,"props":2847,"children":2848},{},[2849],{"type":57,"value":2850},"Platform APIs change.",{"type":57,"value":2852}," Document the version\u002Fdate of any API you reverse-engineer.",{"type":51,"tag":77,"props":2854,"children":2855},{},[2856,2861],{"type":51,"tag":81,"props":2857,"children":2858},{},[2859],{"type":57,"value":2860},"Test with both small and large sites.",{"type":57,"value":2862}," A 5-page portfolio and a 500-page blog exercise different code paths.",{"type":51,"tag":2864,"props":2865,"children":2866},"style",{},[2867],{"type":57,"value":2868},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":2870,"total":3056},[2871,2892,2909,2923,2940,2955,2969,2984,3001,3012,3025,3041],{"slug":2872,"name":2872,"fn":2873,"description":2874,"org":2875,"tags":2876,"stars":2889,"repoUrl":2890,"updatedAt":2891},"annotate","collect visual feedback with browser annotation tools","Open a browser with visual annotation tools. The user clicks elements on their site and leaves feedback — the agent reads annotations and makes changes. Use this when the user wants to point at specific elements to fix, tweak, or redesign.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2877,2880,2883,2886],{"name":2878,"slug":2879,"type":15},"Frontend","frontend",{"name":2881,"slug":2882,"type":15},"Productivity","productivity",{"name":2884,"slug":2885,"type":15},"UX Copy","ux-copy",{"name":2887,"slug":2888,"type":15},"UX Design","ux-design",484,"https:\u002F\u002Fgithub.com\u002FAutomattic\u002Fstudio","2026-05-06T05:40:01.516544",{"slug":2893,"name":2893,"fn":2894,"description":2895,"org":2896,"tags":2897,"stars":2889,"repoUrl":2890,"updatedAt":2908},"block-content","write editable WordPress block markup","Write editable WordPress block markup for local Studio sites, including core\u002Fhtml limits, block-theme layout rules, full-width sections, validation, and skeleton-first page\u002FCSS recipes.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2898,2901,2904,2907],{"name":2899,"slug":2900,"type":15},"Block Editor","block-editor",{"name":2902,"slug":2903,"type":15},"CSS","css",{"name":2905,"slug":2906,"type":15},"HTML","html",{"name":20,"slug":21,"type":15},"2026-05-27T07:01:55.629681",{"slug":2910,"name":2910,"fn":2911,"description":2912,"org":2913,"tags":2914,"stars":2889,"repoUrl":2890,"updatedAt":2922},"hosting-plans-helper","provide WordPress.com hosting plan information","Answer WordPress.com plan, pricing, upgrade, and feature-tier questions (plan names, what each tier unlocks — plugins, themes, custom code, SSH, hosting — and current prices) from authoritative live data. Load before answering ANY plan, pricing, or feature-gating question; never answer these from memory.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2915,2918,2921],{"name":2916,"slug":2917,"type":15},"Pricing","pricing",{"name":2919,"slug":2920,"type":15},"Reference","reference",{"name":20,"slug":21,"type":15},"2026-07-02T07:42:33.654791",{"slug":2924,"name":2924,"fn":2925,"description":2926,"org":2927,"tags":2928,"stars":2889,"repoUrl":2890,"updatedAt":2939},"liberate","migrate websites to WordPress","Import and rebuild a website from a closed platform (Wix, Squarespace, Webflow, Shopify, GoDaddy, Hostinger, HubSpot, Weebly) into a Studio WordPress site. Extracts pages\u002Fposts\u002Fproducts + media, then reconstructs the design as editable blocks + WooCommerce OR as a high-fidelity replica theme. Invoke when the user wants to migrate, import, liberate, or rebuild a site from one of these platforms.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2929,2932,2935,2938],{"name":2930,"slug":2931,"type":15},"CMS","cms",{"name":2933,"slug":2934,"type":15},"Migration","migration",{"name":2936,"slug":2937,"type":15},"Web Development","web-development",{"name":20,"slug":21,"type":15},"2026-07-09T06:47:33.454311",{"slug":2941,"name":2941,"fn":2942,"description":2943,"org":2944,"tags":2945,"stars":2889,"repoUrl":2890,"updatedAt":2954},"need-for-speed","run frontend performance audits for WordPress sites","Run a frontend performance audit on a WordPress site and get actionable optimization recommendations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2946,2949,2950,2953],{"name":2947,"slug":2948,"type":15},"Audit","audit",{"name":2878,"slug":2879,"type":15},{"name":2951,"slug":2952,"type":15},"Performance","performance",{"name":20,"slug":21,"type":15},"2026-05-06T05:40:06.433267",{"slug":2956,"name":2956,"fn":2957,"description":2958,"org":2959,"tags":2960,"stars":2889,"repoUrl":2890,"updatedAt":2968},"plugin-recommendations","recommend WordPress plugins for site features","Choose recommended plugins and plugin-provided blocks for features core WordPress blocks do not cover - ecommerce (WooCommerce), forms and newsletters (Jetpack), online courses and quizzes (Sensei LMS), polls, surveys and ratings (Crowdsignal), spam protection (Akismet) - while keeping generated content editable and avoiding raw HTML fallbacks. Any request to sell products or build a shop, store, or storefront requires WooCommerce with products.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2961,2964,2967],{"name":2962,"slug":2963,"type":15},"Content Creation","content-creation",{"name":2965,"slug":2966,"type":15},"Plugin Development","plugin-development",{"name":20,"slug":21,"type":15},"2026-05-27T07:01:58.249105",{"slug":2970,"name":2970,"fn":2971,"description":2972,"org":2973,"tags":2974,"stars":2889,"repoUrl":2890,"updatedAt":2983},"rank-me-up","run on-page SEO audits for WordPress sites","Run an on-page SEO audit on a WordPress site and get actionable recommendations to improve search visibility.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2975,2976,2979,2982],{"name":2947,"slug":2948,"type":15},{"name":2977,"slug":2978,"type":15},"Marketing","marketing",{"name":2980,"slug":2981,"type":15},"SEO","seo",{"name":20,"slug":21,"type":15},"2026-05-06T05:40:05.196367",{"slug":2985,"name":2985,"fn":2986,"description":2987,"org":2988,"tags":2989,"stars":2889,"repoUrl":2890,"updatedAt":3000},"site-spec","gather specifications for new WordPress sites","Gather the site name and layout preference before building a WordPress site. Run this before creating any new site.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2990,2993,2996,2999],{"name":2991,"slug":2992,"type":15},"Design","design",{"name":2994,"slug":2995,"type":15},"Product Management","product-management",{"name":2997,"slug":2998,"type":15},"Specs","specs",{"name":20,"slug":21,"type":15},"2026-05-06T05:40:02.739409",{"slug":3002,"name":3002,"fn":3003,"description":3004,"org":3005,"tags":3006,"stars":2889,"repoUrl":2890,"updatedAt":3011},"studio-cli","manage local WordPress sites with Studio CLI","Use the Studio CLI to manage local WordPress sites, authentication, and preview sites. Invoke this skill when you need to run Studio CLI commands, manage sites, or troubleshoot site issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3007,3010],{"name":3008,"slug":3009,"type":15},"CLI","cli",{"name":20,"slug":21,"type":15},"2026-04-06T18:02:57.150231",{"slug":3013,"name":3013,"fn":3014,"description":3015,"org":3016,"tags":3017,"stars":2889,"repoUrl":2890,"updatedAt":3024},"taxonomist","optimize WordPress category taxonomy","Analyze and optimize a WordPress site's category taxonomy. Exports all posts, uses AI to suggest an improved category structure — merging duplicates, retiring dead categories, creating missing ones, writing descriptions, and re-categorizing posts. Run this when the user wants to clean up or improve their categories.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3018,3021,3022,3023],{"name":3019,"slug":3020,"type":15},"Content Strategy","content-strategy",{"name":23,"slug":24,"type":15},{"name":2980,"slug":2981,"type":15},{"name":20,"slug":21,"type":15},"2026-05-06T05:40:03.966799",{"slug":3026,"name":3026,"fn":3027,"description":3028,"org":3029,"tags":3030,"stars":2889,"repoUrl":2890,"updatedAt":3040},"visual-design","plan and execute visual design direction","Plan and execute high-quality visual direction for site creation, redesign, layout, typography, color, motion, and visual polish.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3031,3034,3035,3038],{"name":3032,"slug":3033,"type":15},"Animation","animation",{"name":2991,"slug":2992,"type":15},{"name":3036,"slug":3037,"type":15},"Typography","typography",{"name":3039,"slug":3026,"type":15},"Visual Design","2026-07-24T05:40:57.887452",{"slug":3042,"name":3042,"fn":3043,"description":3044,"org":3045,"tags":3046,"stars":2889,"repoUrl":2890,"updatedAt":3055},"visual-polish","verify and polish website visual design","Verify and polish a built or redesigned site by diagnosing rendered-DOM issues against intent and fixing them in a planned, batched screenshot-and-fix loop.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3047,3050,3051,3054],{"name":3048,"slug":3049,"type":15},"Debugging","debugging",{"name":2878,"slug":2879,"type":15},{"name":3052,"slug":3053,"type":15},"Screenshots","screenshots",{"name":3039,"slug":3026,"type":15},"2026-06-06T07:09:59.809812",81,{"items":3058,"total":3147},[3059,3066,3077,3090,3103,3118,3134],{"slug":4,"name":4,"fn":5,"description":6,"org":3060,"tags":3061,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3062,3063,3064,3065],{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":3067,"name":3067,"fn":3068,"description":3069,"org":3070,"tags":3071,"stars":25,"repoUrl":26,"updatedAt":3076},"compose-page-blocks","compose WordPress block markup from HTML","Compose a single liberated page's WordPress block-editor markup from its rendered HTML and screenshot. Inputs are a sanitized HTML file, a desktop screenshot, the design-foundation tokens, the URL's archetype (page\u002Fpost\u002Fproduct\u002Fetc.), and the source URL. Output is a string of valid block markup that round-trips through parse_blocks, uses theme tokens (no inlined hex colors), and contains only text drawn from the source HTML. Call per-page during the streaming watch loop after extraction has produced HTML+screenshot for that URL. Use when a freshly-imported page needs `post_content` upgraded from raw HTML into block-editor markup so the replica theme's tokens, gradients, and patterns actually render.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3072,3073,3074,3075],{"name":2899,"slug":2900,"type":15},{"name":2962,"slug":2963,"type":15},{"name":2905,"slug":2906,"type":15},{"name":20,"slug":21,"type":15},"2026-06-08T08:17:34.212397",{"slug":3078,"name":3078,"fn":3079,"description":3080,"org":3081,"tags":3082,"stars":25,"repoUrl":26,"updatedAt":3089},"creating-blocks","create new WordPress blocks","Templates and guidelines for creating new WordPress blocks from scratch — load this before generating block files",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3083,3084,3087,3088],{"name":2899,"slug":2900,"type":15},{"name":3085,"slug":3086,"type":15},"Full Site Editing","full-site-editing",{"name":2965,"slug":2966,"type":15},{"name":20,"slug":21,"type":15},"2026-06-08T08:17:49.413995",{"slug":3091,"name":3091,"fn":3092,"description":3093,"org":3094,"tags":3095,"stars":25,"repoUrl":26,"updatedAt":3102},"creating-themes","create WordPress block themes","Guidelines for creating new WordPress block themes from scratch — load this before generating theme files",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3096,3097,3098,3101],{"name":2899,"slug":2900,"type":15},{"name":3085,"slug":3086,"type":15},{"name":3099,"slug":3100,"type":15},"Themes","themes",{"name":20,"slug":21,"type":15},"2026-06-08T08:17:50.666611",{"slug":3104,"name":3104,"fn":3105,"description":3106,"org":3107,"tags":3108,"stars":25,"repoUrl":26,"updatedAt":3117},"design-foundations","build design foundation JSON from sites","Build a coherent design-foundation JSON from a liberated site — semantic color\u002Ftypography\u002Fspacing roles with evidence trails. Consumes the partial scaffold produced by liberate_design_foundation_scaffold plus aggregate HTML\u002FCSS analysis and representative rendered HTML; produces a complete design-foundation matching the schema. Call after liberation, before theme generation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3109,3112,3113,3116],{"name":3110,"slug":3111,"type":15},"Data Modeling","data-modeling",{"name":2991,"slug":2992,"type":15},{"name":3114,"slug":3115,"type":15},"Design System","design-system",{"name":2878,"slug":2879,"type":15},"2026-06-08T08:17:44.457834",{"slug":3119,"name":3119,"fn":3120,"description":3121,"org":3122,"tags":3123,"stars":25,"repoUrl":26,"updatedAt":3133},"design-qa","run visual QA on WordPress themes","Visual-QA loop run after replica theme install and content import. Captures replica screenshots, applies a hard responsiveness gate at 390px AND a hard per-section visual-parity gate (measured SectionParity records, verdict computed by buildRunReport), runs qualitative vision review of source\u002Freplica pairs, checks accessibility, and drives a per-section escalation ladder of fixes via editing-themes\u002Fediting-blocks\u002Frebuild-section (R1 CSS → R2 spec-rebuild → R3 re-extract → R4a AI canonical-block rebuild → R4b deterministic styled-island floor) — escalating unresolved divergences to the operator rather than shipping them. Orchestration-internal — invoked by the replicate-with-blocks\u002Fliberate orchestrators, not directly by users.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3124,3127,3128,3131,3132],{"name":3125,"slug":3126,"type":15},"QA","qa",{"name":3052,"slug":3053,"type":15},{"name":3129,"slug":3130,"type":15},"Testing","testing",{"name":3099,"slug":3100,"type":15},{"name":20,"slug":21,"type":15},"2026-06-08T08:17:45.698278",{"slug":3135,"name":3135,"fn":3136,"description":3137,"org":3138,"tags":3139,"stars":25,"repoUrl":26,"updatedAt":3146},"diagnose","debug failed data extraction processes","Debug failed or low-quality extractions by analyzing logs, probing the source site, and identifying root causes",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3140,3141,3142,3145],{"name":13,"slug":14,"type":15},{"name":3048,"slug":3049,"type":15},{"name":3143,"slug":3144,"type":15},"Logs","logs",{"name":3125,"slug":3126,"type":15},"2026-05-10T05:48:11.267642",21]