[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6C2KVEK4A3DWRVTPP2P11RB":3,"skill-same:01M6C2KVEK4A3DWRVTPP2P11RB":105},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":34,"publishedAt":62,"linkOnly":63,"markdownContent":64,"markdownBody":65,"frontMatter":66,"refName":75,"commitSha":76,"skillDirectory":77,"forksCount":14,"repositoryHtmlUrl":78,"repositoryHomepageUrl":6,"ownerHtmlUrl":79,"ownerBlogUrl":6,"ownerDescription":80,"updatedAt":81,"install":82,"resources":94},"01M6C2KVEK4A3DWRVTPP2P11RB","seo-ecommerce",null,"E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing analysis, and marketplace keyword gaps. Combines on-page product SEO with marketplace data from DataForSEO Merchant API. Use when user says \"ecommerce SEO\", \"product SEO\", \"Google Shopping\", \"marketplace SEO\", \"product schema\", \"Amazon SEO\", \"product listings\", \"shopping ads\", or \"merchant SEO\".","noirelab\u002Flinux-setup","noirelab","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142925921?v=4","01M6C29R3FEDGFAXAT0KXY28QX","Kaíque M. Lima","01M6C29R811WX04B0GYHTH1XV6",0,"MIT","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fclaude\u002Fskills\u002Fseo-ecommerce\u002FSKILL.md",[18,23,26,31],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000019","营销推广",{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",{"categoryNo":32,"categoryName":33,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000035","市场营销",[35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61],"seo","ecommerce","seo ecommerce","use","when","merchant","URL","commerce","seo analysis","e-commerce","google shopping","listings","intelligence","shopping","schema","google","user","challenge","page","ads","api","analysis","data","marketplace","product","validation","pricing","2026-11-10 10:12:30",false,"---\nname: seo-ecommerce\ndescription: >\n  E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace\n  intelligence, product schema validation, competitor pricing analysis, and\n  marketplace keyword gaps. Combines on-page product SEO with marketplace data\n  from DataForSEO Merchant API. Use when user says \"ecommerce SEO\", \"product SEO\",\n  \"Google Shopping\", \"marketplace SEO\", \"product schema\", \"Amazon SEO\",\n  \"product listings\", \"shopping ads\", or \"merchant SEO\".\nuser-invocable: true\nargument-hint: \"\u003Curl or keyword>\"\nlicense: MIT\ncompatibility: \"Enhanced with DataForSEO Merchant API (optional)\"\nmetadata:\n  author: AgriciDaniel\n  original_author: \"Matej Marjanovic (Pro Hub Challenge)\"\n  version: \"2.2.4\"\n  category: seo\n---\n\n# E-commerce SEO Analysis\n\nComprehensive product page optimization, marketplace intelligence, and\ncompetitive pricing analysis. Works standalone (on-page + schema) and with\nDataForSEO Merchant API for live Google Shopping and Amazon data.\n\n## Commands\n\n| Command | Purpose | DataForSEO? |\n|---------|---------|-------------|\n| `\u002Fseo ecommerce \u003Curl>` | Full e-commerce SEO analysis of a product page or store | Optional |\n| `\u002Fseo ecommerce products \u003Ckeyword>` | Google Shopping competitive analysis | Required |\n| `\u002Fseo ecommerce gaps \u003Cdomain>` | Keyword gap: organic vs Shopping visibility | Required |\n| `\u002Fseo ecommerce schema \u003Curl>` | Product schema validation and enhancement | No |\n\n---\n\n## 1. Product Page Analysis (No DataForSEO Needed)\n\nFetch and parse any product page for on-page SEO quality.\n\n### Workflow\n\n```\n1. \u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run render_page.py \u003Curl> --mode auto → raw\u002Frendered HTML\n2. \u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run parse_html.py --url \u003Curl>   → SEO elements\n3. Analyze product-specific signals (below)\n```\n\n### Product SEO Checklist\n\n#### Title Tag\n- [ ] Contains primary product keyword\n- [ ] Includes brand name\n- [ ] Under 60 characters (no truncation in SERPs)\n- [ ] Format: `[Product Name] - [Key Feature] | [Brand]`\n\n#### Meta Description\n- [ ] Contains product keyword + benefit\n- [ ] Includes price or \"from $XX\" (triggers rich snippet interest)\n- [ ] Call-to-action present (Shop now, Buy, Free shipping)\n- [ ] Under 155 characters\n\n#### Heading Structure\n- [ ] Single H1 matching primary product name\n- [ ] H2s for: Features, Specifications, Reviews, Related Products\n- [ ] No duplicate H1 tags across product variants\n\n#### Product Images\n- [ ] Alt text includes product name + distinguishing feature\n- [ ] File names are descriptive (not `IMG_001.jpg`)\n- [ ] WebP format served (with JPEG fallback)\n- [ ] At least 3 images per product (hero, detail, lifestyle)\n- [ ] Image dimensions >= 800px for Google Shopping eligibility\n- [ ] Lazy loading on below-fold images only\n\n#### Internal Linking\n- [ ] Breadcrumb navigation: Home > Category > Subcategory > Product\n- [ ] Related products section (cross-sell \u002F upsell)\n- [ ] Link back to category page with keyword-rich anchor\n- [ ] Reviews section links to full review page (if separate)\n\n#### Content Quality\n- [ ] Unique product description (not manufacturer copy-paste)\n- [ ] Word count >= 200 for product description body\n- [ ] Specs table present (not just prose)\n- [ ] User reviews on-page (UGC signals)\n\n### Scoring\n\n| Category | Weight | Criteria |\n|----------|--------|----------|\n| Schema completeness | 25% | Required + recommended Product fields |\n| Title & meta | 15% | Keyword placement, length, format |\n| Image optimization | 20% | Alt text, format, sizing, count |\n| Content quality | 20% | Unique description, specs, reviews |\n| Internal linking | 10% | Breadcrumbs, related products, categories |\n| Technical | 10% | Page speed, mobile rendering, canonical |\n\n---\n\n## 2. Google Shopping Intelligence (DataForSEO Merchant API)\n\nLive competitive analysis from Google Shopping results.\n\n### Cost Guardrail (MANDATORY)\n\nBefore EVERY Merchant API call:\n```bash\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_costs.py check merchant_google_products_search\n```\n\n- `\"status\": \"approved\"` -- proceed\n- `\"status\": \"needs_approval\"` -- show cost, ask user\n- `\"status\": \"blocked\"` -- stop, inform user\n\nAfter each call:\n```bash\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_costs.py log merchant_google_products_search \u003Ccost>\n```\n\n### Workflow\n\n```bash\n# Product search: who sells what at what price\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_merchant.py search \"\u003Ckeyword>\" --marketplace google\n\n# Seller analysis: merchant ratings and dominance\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_merchant.py sellers \"\u003Ckeyword>\"\n\n# Normalize results for analysis\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_normalize.py results.json --module merchant\n```\n\n### Analysis Outputs\n\n#### Pricing Intelligence\n- Price distribution: min, max, median, P25, P75\n- Price outliers (> 2 standard deviations from median)\n- Price-to-rating correlation\n- Currency normalization to USD (or user-specified)\n\n#### Seller Landscape\n- Top 10 sellers by listing count\n- Merchant rating distribution\n- Free shipping prevalence\n- New vs established sellers\n\n#### Product Listing Quality\n- Title keyword patterns in top listings\n- Average rating and review count benchmarks\n- Image count per listing\n- Availability status distribution\n\nLoad `references\u002Fmarketplace-endpoints.md` for full API parameter details.\n\n---\n\n## 3. Amazon Marketplace (DataForSEO)\n\nCross-marketplace intelligence comparing Google Shopping and Amazon.\n\n### Cost Guardrail (MANDATORY)\n\n```bash\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_costs.py check merchant_amazon_products_search\n```\n\nAmazon endpoints are in the `warn_endpoints` set -- always requires user approval.\n\n### Workflow\n\n```bash\n# Amazon product search\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_merchant.py search \"\u003Ckeyword>\" --marketplace amazon\n\n# Cross-marketplace comparison\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_merchant.py compare \"\u003Ckeyword>\"\n```\n\n### Cross-Marketplace Report\n\n| Metric | Google Shopping | Amazon |\n|--------|---------------|--------|\n| Avg price | $ | $ |\n| Median rating | X.X | X.X |\n| Avg review count | N | N |\n| Top seller share | % | % |\n| Free shipping % | % | % |\n\n---\n\n## 4. Marketplace Keyword Gaps\n\nIdentify mismatches between organic and Shopping visibility.\n\n### Workflow\n\n1. Fetch organic rankings via seo-dataforseo:\n   `dataforseo_labs_google_ranked_keywords` for domain\n2. Fetch Google Shopping presence via Merchant API:\n   `merchant_google_products_search` for top organic keywords\n3. Cross-reference results\n\n### Gap Types\n\n| Gap Type | Meaning | Action |\n|----------|---------|--------|\n| **Organic Only** | Ranks organically but no Shopping ads | Create Google Merchant Center feed, bid on these keywords |\n| **Shopping Only** | Shopping visibility but weak\u002Fno organic | Create content (buying guides, comparison pages) for these keywords |\n| **Both Present** | Visible in both channels | Optimize: ensure price consistency, enhance schema |\n| **Neither** | No visibility in either | Low priority unless high volume |\n\n### Output Format\n\n```\n## Keyword Gap Analysis: example.com\n\n### Opportunities: Organic → Shopping (12 keywords)\n| Keyword | Organic Pos | Volume | CPC | Recommended Action |\n|---------|------------|--------|-----|-------------------|\n\n### Opportunities: Shopping → Organic (8 keywords)\n| Keyword | Shopping Rank | Volume | CPC | Content Type Needed |\n|---------|-------------|--------|-----|-------------------|\n```\n\n---\n\n## 5. Product Schema Enhancement\n\nValidate and generate Product schema following Google's current requirements.\n\n### Confirmed Required Properties (Google Merchant)\n\nConfirmed required fields are `name`, `image`, and `offers`; use `Offer`, not `AggregateOffer`, for merchant listings.\n\n```json\n{\n  \"@context\": \"https:\u002F\u002Fschema.org\",\n  \"@type\": \"Product\",\n  \"name\": \"\",\n  \"image\": [\"\"],\n  \"offers\": {\n    \"@type\": \"Offer\",\n    \"url\": \"\",\n    \"priceCurrency\": \"USD\",\n    \"price\": \"0.00\",\n    \"availability\": \"https:\u002F\u002Fschema.org\u002FInStock\"\n  }\n}\n```\n\n### Recommended Properties (Enhance Rich Results)\n\n- `sku` -- product identifier\n- `description`, `brand`, `offers.seller` -- recommended context fields\n- `gtin13` \u002F `gtin14` \u002F `mpn` -- global trade identifiers\n- `aggregateRating` -- star rating + review count\n- `review` -- individual reviews (minimum 1)\n- `color`, `material`, `size` -- variant attributes\n- `shippingDetails` -- ShippingDetails with rate and delivery time (merchant-level shipping via `ShippingService` is also supported; shipping\u002Freturns can be set in Search Console without a Merchant Center account)\n- `hasMerchantReturnPolicy` -- MerchantReturnPolicy with type and days\n- `hasAdultConsideration` -- **required for adult-oriented products** (added 2026-05-20 to Product variant \u002F Merchant listing); Google Search supports only the value `https:\u002F\u002Fschema.org\u002FSexualContentConsideration`\n\n### Validation Rules\n\n1. `price` must be a number string, not \"$29.99\" (no currency symbol)\n2. `availability` must use full Schema.org URL enum\n3. `image` should be array with >= 1 high-res image URL\n4. `priceCurrency` must be ISO 4217 (USD, EUR, GBP)\n5. If `brand` is present, `brand.name` must not be empty or \"N\u002FA\"\n6. Dates in `priceValidUntil` must be ISO 8601\n7. If `aggregateRating` present: `ratingValue` and `reviewCount` required\n\n### Schema Scoring\n\n| Completeness | Score |\n|-------------|-------|\n| All required fields | 50\u002F100 |\n| + aggregateRating | 65\u002F100 |\n| + sku\u002Fgtin\u002Fmpn | 75\u002F100 |\n| + shippingDetails | 85\u002F100 |\n| + merchantReturnPolicy | 90\u002F100 |\n| + reviews (3+) | 100\u002F100 |\n\n---\n\n## Cross-Skill Integration\n\n| Skill | Integration Point |\n|-------|------------------|\n| **seo-schema** | Delegates Product schema generation; reuses validation logic |\n| **seo-images** | Product image audit (alt text, format, dimensions), plus `DigitalSourceType: TrainedAlgorithmicMedia` IPTC label for AI-generated product images (Merchant Center requirement) |\n| **seo-content** | Product description E-E-A-T and uniqueness analysis |\n| **seo-dataforseo** | Organic keyword rankings for gap analysis |\n| **seo-technical** | Core Web Vitals for product pages (LCP on hero image) |\n| **seo-google** | GSC indexation + Performance data for product URLs (NOT Merchant Center feed validation, that is done in Merchant Center \u002F the **Merchant API**; the legacy Content API for Shopping sunsets 2026-08-18) |\n\n## UCP: Universal Commerce Protocol (live)\n\nGoogle-initiated open standard (co-developed with Shopify, Etsy, Wayfair,\nTarget, Walmart; payment partners Visa\u002FMastercard\u002FStripe\u002FAdyen\u002FAmex) for\nletting AI agents discover, negotiate, and transact with merchants without\none-off integrations. Google confirms a first reference implementation for\nconversational buying in AI Mode in Search. Broader Universal Cart rollout\ndetails are reported from Google I\u002FO 2026 keynote coverage; not confirmed on a\nGoogle-owned source. ucp.dev lists **2026-04-08** as the latest release in its\n**date-based versioning** scheme, not `1.0`; two integration paths: **Native**\n(default) and **Embedded** (approved merchants). Pairs with **AP2** (reportedly\nmoving toward FIDO governance). Canonical: developers.google.com\u002Fmerchant\u002Fucp\nand ucp.dev.\n\nMerchants already on **Google Merchant Center** with clean Product schema can\ndeclare a UCP profile at `\u002F.well-known\u002Fucp` listing capabilities\n(`dev.ucp.shopping.checkout`, `.fulfillment`, `.discount`). See\n`references\u002Fucp-universal-commerce-protocol.md` for audit criteria,\ncapability examples, and the relationship to AP2 (Agent Payments Protocol).\n\n### Audit command\n\n```bash\n# Discover and validate the UCP profile\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run ucp_check.py https:\u002F\u002Fstore.example.com --json\n\n# With endpoint reachability probes (HEAD each declared capability)\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run ucp_check.py https:\u002F\u002Fstore.example.com --probe-endpoints --json\n```\n\nThe script returns: profile presence, version, declared capabilities,\nstructural issues (missing fields, unknown capability IDs), and (with\n`--probe-endpoints`) per-endpoint reachability. SSRF-blocked endpoints are\nreported explicitly. Missing profile is reported as opportunity, not failure.\nUCP itself is live; what's early is broad merchant adoption. Flag a literal\n`\"version\": \"1.0\"` as invalid (UCP versions are date-based, e.g. `2026-04-08`).\n\n---\n\n## Error Handling\n\n| Error | Cause | Response |\n|-------|-------|----------|\n| No Product schema found | Page lacks JSON-LD | Analyze page content, generate recommended schema |\n| DataForSEO credentials missing | Env vars not set | Run analysis without marketplace data, note limitation |\n| Cost check blocked | Daily budget exceeded | Inform user, offer free-only analysis |\n| Empty Shopping results | No products for keyword | Suggest broader keyword, check location settings |\n| Amazon API timeout | Network\u002Frate limit | Retry with backoff, fall back to Google-only |\n| Invalid URL | Malformed input | Validate via `google_auth.validate_url()`, show error |\n| Non-product page | URL is category\u002Fhomepage | Detect page type, suggest `\u002Fseo ecommerce schema` instead |\n\n---\n\n## Output Template\n\n```\n## E-commerce SEO Report: [URL or Keyword]\n\n### Overall Score: XX\u002F100\n\n### Product Page SEO\n- Schema Completeness: XX\u002F100\n- Title & Meta: XX\u002F100\n- Image Optimization: XX\u002F100\n- Content Quality: XX\u002F100\n- Internal Linking: XX\u002F100\n\n### Marketplace Intelligence (if DataForSEO available)\n- Google Shopping Listings: N products found\n- Price Range: $XX - $XX (median: $XX)\n- Top Seller: [name] (XX% market share)\n- Amazon Comparison: [available\u002Fnot checked]\n\n### Top Recommendations\n1. [Critical] ...\n2. [High] ...\n3. [Medium] ...\n\nGenerate a PDF report? Use `\u002Fseo google report`\n```\n","# E-commerce SEO Analysis\n\nComprehensive product page optimization, marketplace intelligence, and\ncompetitive pricing analysis. Works standalone (on-page + schema) and with\nDataForSEO Merchant API for live Google Shopping and Amazon data.\n\n## Commands\n\n| Command | Purpose | DataForSEO? |\n|---------|---------|-------------|\n| `\u002Fseo ecommerce \u003Curl>` | Full e-commerce SEO analysis of a product page or store | Optional |\n| `\u002Fseo ecommerce products \u003Ckeyword>` | Google Shopping competitive analysis | Required |\n| `\u002Fseo ecommerce gaps \u003Cdomain>` | Keyword gap: organic vs Shopping visibility | Required |\n| `\u002Fseo ecommerce schema \u003Curl>` | Product schema validation and enhancement | No |\n\n---\n\n## 1. Product Page Analysis (No DataForSEO Needed)\n\nFetch and parse any product page for on-page SEO quality.\n\n### Workflow\n\n```\n1. \u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run render_page.py \u003Curl> --mode auto → raw\u002Frendered HTML\n2. \u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run parse_html.py --url \u003Curl>   → SEO elements\n3. Analyze product-specific signals (below)\n```\n\n### Product SEO Checklist\n\n#### Title Tag\n- [ ] Contains primary product keyword\n- [ ] Includes brand name\n- [ ] Under 60 characters (no truncation in SERPs)\n- [ ] Format: `[Product Name] - [Key Feature] | [Brand]`\n\n#### Meta Description\n- [ ] Contains product keyword + benefit\n- [ ] Includes price or \"from $XX\" (triggers rich snippet interest)\n- [ ] Call-to-action present (Shop now, Buy, Free shipping)\n- [ ] Under 155 characters\n\n#### Heading Structure\n- [ ] Single H1 matching primary product name\n- [ ] H2s for: Features, Specifications, Reviews, Related Products\n- [ ] No duplicate H1 tags across product variants\n\n#### Product Images\n- [ ] Alt text includes product name + distinguishing feature\n- [ ] File names are descriptive (not `IMG_001.jpg`)\n- [ ] WebP format served (with JPEG fallback)\n- [ ] At least 3 images per product (hero, detail, lifestyle)\n- [ ] Image dimensions >= 800px for Google Shopping eligibility\n- [ ] Lazy loading on below-fold images only\n\n#### Internal Linking\n- [ ] Breadcrumb navigation: Home > Category > Subcategory > Product\n- [ ] Related products section (cross-sell \u002F upsell)\n- [ ] Link back to category page with keyword-rich anchor\n- [ ] Reviews section links to full review page (if separate)\n\n#### Content Quality\n- [ ] Unique product description (not manufacturer copy-paste)\n- [ ] Word count >= 200 for product description body\n- [ ] Specs table present (not just prose)\n- [ ] User reviews on-page (UGC signals)\n\n### Scoring\n\n| Category | Weight | Criteria |\n|----------|--------|----------|\n| Schema completeness | 25% | Required + recommended Product fields |\n| Title & meta | 15% | Keyword placement, length, format |\n| Image optimization | 20% | Alt text, format, sizing, count |\n| Content quality | 20% | Unique description, specs, reviews |\n| Internal linking | 10% | Breadcrumbs, related products, categories |\n| Technical | 10% | Page speed, mobile rendering, canonical |\n\n---\n\n## 2. Google Shopping Intelligence (DataForSEO Merchant API)\n\nLive competitive analysis from Google Shopping results.\n\n### Cost Guardrail (MANDATORY)\n\nBefore EVERY Merchant API call:\n```bash\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_costs.py check merchant_google_products_search\n```\n\n- `\"status\": \"approved\"` -- proceed\n- `\"status\": \"needs_approval\"` -- show cost, ask user\n- `\"status\": \"blocked\"` -- stop, inform user\n\nAfter each call:\n```bash\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_costs.py log merchant_google_products_search \u003Ccost>\n```\n\n### Workflow\n\n```bash\n# Product search: who sells what at what price\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_merchant.py search \"\u003Ckeyword>\" --marketplace google\n\n# Seller analysis: merchant ratings and dominance\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_merchant.py sellers \"\u003Ckeyword>\"\n\n# Normalize results for analysis\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_normalize.py results.json --module merchant\n```\n\n### Analysis Outputs\n\n#### Pricing Intelligence\n- Price distribution: min, max, median, P25, P75\n- Price outliers (> 2 standard deviations from median)\n- Price-to-rating correlation\n- Currency normalization to USD (or user-specified)\n\n#### Seller Landscape\n- Top 10 sellers by listing count\n- Merchant rating distribution\n- Free shipping prevalence\n- New vs established sellers\n\n#### Product Listing Quality\n- Title keyword patterns in top listings\n- Average rating and review count benchmarks\n- Image count per listing\n- Availability status distribution\n\nLoad `references\u002Fmarketplace-endpoints.md` for full API parameter details.\n\n---\n\n## 3. Amazon Marketplace (DataForSEO)\n\nCross-marketplace intelligence comparing Google Shopping and Amazon.\n\n### Cost Guardrail (MANDATORY)\n\n```bash\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_costs.py check merchant_amazon_products_search\n```\n\nAmazon endpoints are in the `warn_endpoints` set -- always requires user approval.\n\n### Workflow\n\n```bash\n# Amazon product search\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_merchant.py search \"\u003Ckeyword>\" --marketplace amazon\n\n# Cross-marketplace comparison\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run dataforseo_merchant.py compare \"\u003Ckeyword>\"\n```\n\n### Cross-Marketplace Report\n\n| Metric | Google Shopping | Amazon |\n|--------|---------------|--------|\n| Avg price | $ | $ |\n| Median rating | X.X | X.X |\n| Avg review count | N | N |\n| Top seller share | % | % |\n| Free shipping % | % | % |\n\n---\n\n## 4. Marketplace Keyword Gaps\n\nIdentify mismatches between organic and Shopping visibility.\n\n### Workflow\n\n1. Fetch organic rankings via seo-dataforseo:\n   `dataforseo_labs_google_ranked_keywords` for domain\n2. Fetch Google Shopping presence via Merchant API:\n   `merchant_google_products_search` for top organic keywords\n3. Cross-reference results\n\n### Gap Types\n\n| Gap Type | Meaning | Action |\n|----------|---------|--------|\n| **Organic Only** | Ranks organically but no Shopping ads | Create Google Merchant Center feed, bid on these keywords |\n| **Shopping Only** | Shopping visibility but weak\u002Fno organic | Create content (buying guides, comparison pages) for these keywords |\n| **Both Present** | Visible in both channels | Optimize: ensure price consistency, enhance schema |\n| **Neither** | No visibility in either | Low priority unless high volume |\n\n### Output Format\n\n```\n## Keyword Gap Analysis: example.com\n\n### Opportunities: Organic → Shopping (12 keywords)\n| Keyword | Organic Pos | Volume | CPC | Recommended Action |\n|---------|------------|--------|-----|-------------------|\n\n### Opportunities: Shopping → Organic (8 keywords)\n| Keyword | Shopping Rank | Volume | CPC | Content Type Needed |\n|---------|-------------|--------|-----|-------------------|\n```\n\n---\n\n## 5. Product Schema Enhancement\n\nValidate and generate Product schema following Google's current requirements.\n\n### Confirmed Required Properties (Google Merchant)\n\nConfirmed required fields are `name`, `image`, and `offers`; use `Offer`, not `AggregateOffer`, for merchant listings.\n\n```json\n{\n  \"@context\": \"https:\u002F\u002Fschema.org\",\n  \"@type\": \"Product\",\n  \"name\": \"\",\n  \"image\": [\"\"],\n  \"offers\": {\n    \"@type\": \"Offer\",\n    \"url\": \"\",\n    \"priceCurrency\": \"USD\",\n    \"price\": \"0.00\",\n    \"availability\": \"https:\u002F\u002Fschema.org\u002FInStock\"\n  }\n}\n```\n\n### Recommended Properties (Enhance Rich Results)\n\n- `sku` -- product identifier\n- `description`, `brand`, `offers.seller` -- recommended context fields\n- `gtin13` \u002F `gtin14` \u002F `mpn` -- global trade identifiers\n- `aggregateRating` -- star rating + review count\n- `review` -- individual reviews (minimum 1)\n- `color`, `material`, `size` -- variant attributes\n- `shippingDetails` -- ShippingDetails with rate and delivery time (merchant-level shipping via `ShippingService` is also supported; shipping\u002Freturns can be set in Search Console without a Merchant Center account)\n- `hasMerchantReturnPolicy` -- MerchantReturnPolicy with type and days\n- `hasAdultConsideration` -- **required for adult-oriented products** (added 2026-05-20 to Product variant \u002F Merchant listing); Google Search supports only the value `https:\u002F\u002Fschema.org\u002FSexualContentConsideration`\n\n### Validation Rules\n\n1. `price` must be a number string, not \"$29.99\" (no currency symbol)\n2. `availability` must use full Schema.org URL enum\n3. `image` should be array with >= 1 high-res image URL\n4. `priceCurrency` must be ISO 4217 (USD, EUR, GBP)\n5. If `brand` is present, `brand.name` must not be empty or \"N\u002FA\"\n6. Dates in `priceValidUntil` must be ISO 8601\n7. If `aggregateRating` present: `ratingValue` and `reviewCount` required\n\n### Schema Scoring\n\n| Completeness | Score |\n|-------------|-------|\n| All required fields | 50\u002F100 |\n| + aggregateRating | 65\u002F100 |\n| + sku\u002Fgtin\u002Fmpn | 75\u002F100 |\n| + shippingDetails | 85\u002F100 |\n| + merchantReturnPolicy | 90\u002F100 |\n| + reviews (3+) | 100\u002F100 |\n\n---\n\n## Cross-Skill Integration\n\n| Skill | Integration Point |\n|-------|------------------|\n| **seo-schema** | Delegates Product schema generation; reuses validation logic |\n| **seo-images** | Product image audit (alt text, format, dimensions), plus `DigitalSourceType: TrainedAlgorithmicMedia` IPTC label for AI-generated product images (Merchant Center requirement) |\n| **seo-content** | Product description E-E-A-T and uniqueness analysis |\n| **seo-dataforseo** | Organic keyword rankings for gap analysis |\n| **seo-technical** | Core Web Vitals for product pages (LCP on hero image) |\n| **seo-google** | GSC indexation + Performance data for product URLs (NOT Merchant Center feed validation, that is done in Merchant Center \u002F the **Merchant API**; the legacy Content API for Shopping sunsets 2026-08-18) |\n\n## UCP: Universal Commerce Protocol (live)\n\nGoogle-initiated open standard (co-developed with Shopify, Etsy, Wayfair,\nTarget, Walmart; payment partners Visa\u002FMastercard\u002FStripe\u002FAdyen\u002FAmex) for\nletting AI agents discover, negotiate, and transact with merchants without\none-off integrations. Google confirms a first reference implementation for\nconversational buying in AI Mode in Search. Broader Universal Cart rollout\ndetails are reported from Google I\u002FO 2026 keynote coverage; not confirmed on a\nGoogle-owned source. ucp.dev lists **2026-04-08** as the latest release in its\n**date-based versioning** scheme, not `1.0`; two integration paths: **Native**\n(default) and **Embedded** (approved merchants). Pairs with **AP2** (reportedly\nmoving toward FIDO governance). Canonical: developers.google.com\u002Fmerchant\u002Fucp\nand ucp.dev.\n\nMerchants already on **Google Merchant Center** with clean Product schema can\ndeclare a UCP profile at `\u002F.well-known\u002Fucp` listing capabilities\n(`dev.ucp.shopping.checkout`, `.fulfillment`, `.discount`). See\n`references\u002Fucp-universal-commerce-protocol.md` for audit criteria,\ncapability examples, and the relationship to AP2 (Agent Payments Protocol).\n\n### Audit command\n\n```bash\n# Discover and validate the UCP profile\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run ucp_check.py https:\u002F\u002Fstore.example.com --json\n\n# With endpoint reachability probes (HEAD each declared capability)\n\u002Fhome\u002Fnoirelab\u002F.config\u002Fopencode\u002Fskills\u002Fseo\u002Fbin\u002Fclaude-seo run ucp_check.py https:\u002F\u002Fstore.example.com --probe-endpoints --json\n```\n\nThe script returns: profile presence, version, declared capabilities,\nstructural issues (missing fields, unknown capability IDs), and (with\n`--probe-endpoints`) per-endpoint reachability. SSRF-blocked endpoints are\nreported explicitly. Missing profile is reported as opportunity, not failure.\nUCP itself is live; what's early is broad merchant adoption. Flag a literal\n`\"version\": \"1.0\"` as invalid (UCP versions are date-based, e.g. `2026-04-08`).\n\n---\n\n## Error Handling\n\n| Error | Cause | Response |\n|-------|-------|----------|\n| No Product schema found | Page lacks JSON-LD | Analyze page content, generate recommended schema |\n| DataForSEO credentials missing | Env vars not set | Run analysis without marketplace data, note limitation |\n| Cost check blocked | Daily budget exceeded | Inform user, offer free-only analysis |\n| Empty Shopping results | No products for keyword | Suggest broader keyword, check location settings |\n| Amazon API timeout | Network\u002Frate limit | Retry with backoff, fall back to Google-only |\n| Invalid URL | Malformed input | Validate via `google_auth.validate_url()`, show error |\n| Non-product page | URL is category\u002Fhomepage | Detect page type, suggest `\u002Fseo ecommerce schema` instead |\n\n---\n\n## Output Template\n\n```\n## E-commerce SEO Report: [URL or Keyword]\n\n### Overall Score: XX\u002F100\n\n### Product Page SEO\n- Schema Completeness: XX\u002F100\n- Title & Meta: XX\u002F100\n- Image Optimization: XX\u002F100\n- Content Quality: XX\u002F100\n- Internal Linking: XX\u002F100\n\n### Marketplace Intelligence (if DataForSEO available)\n- Google Shopping Listings: N products found\n- Price Range: $XX - $XX (median: $XX)\n- Top Seller: [name] (XX% market share)\n- Amazon Comparison: [available\u002Fnot checked]\n\n### Top Recommendations\n1. [Critical] ...\n2. [High] ...\n3. [Medium] ...\n\nGenerate a PDF report? Use `\u002Fseo google report`\n```\n",{"name":5,"license":15,"metadata":67,"description":71,"argument-hint":72,"compatibility":73,"user-invocable":74},{"author":68,"version":69,"category":35,"original_author":70},"AgriciDaniel","2.2.4","Matej Marjanovic (Pro Hub Challenge)","E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing analysis, and marketplace keyword gaps. Combines on-page product SEO with marketplace data from DataForSEO Merchant API. Use when user says \"ecommerce SEO\", \"product SEO\", \"Google Shopping\", \"marketplace SEO\", \"product schema\", \"Amazon SEO\", \"product listings\", \"shopping ads\", or \"merchant SEO\".\n","\u003Curl or keyword>","Enhanced with DataForSEO Merchant API (optional)",true,"main","d8378e461d60315bd1ca8a6e71716df39b6abe4a","configs\u002Fcommon\u002Fclaude\u002Fskills\u002Fseo-ecommerce","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup","https:\u002F\u002Fgithub.com\u002Fnoirelab","Artificial Intelligence Researcher |\r\nComputer Science majoring at UTFPR","2026-11-11 09:12:51",{"source":8,"skillName":5,"commands":83,"prompt":93,"zipAvailable":74},[84,87,90],{"tool":85,"command":86},"npx","npx skills add noirelab\u002Flinux-setup --skill seo-ecommerce",{"tool":88,"command":89},"bunx","bunx skills add noirelab\u002Flinux-setup --skill seo-ecommerce",{"tool":91,"command":92},"pnpm","pnpm dlx skills add noirelab\u002Flinux-setup --skill seo-ecommerce","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fclaude\u002Fskills\u002Fseo-ecommerce\u002FSKILL.md",[95,101],{"path":96,"resourceType":97,"resourceTypeDesc":98,"sizeBytes":99,"sourceHtmlUrl":100},"references\u002Fmarketplace-endpoints.md","REFERENCE","参考文档",3801,"https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fclaude\u002Fskills\u002Fseo-ecommerce\u002Freferences\u002Fmarketplace-endpoints.md",{"path":102,"resourceType":97,"resourceTypeDesc":98,"sizeBytes":103,"sourceHtmlUrl":104},"references\u002Fucp-universal-commerce-protocol.md",7336,"https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fclaude\u002Fskills\u002Fseo-ecommerce\u002Freferences\u002Fucp-universal-commerce-protocol.md",[106,136,170,195,215,231],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":110,"licenseFileUrl":111,"sourceHtmlUrl":112,"categories":113,"keywords":117,"publishedAt":62},"01M6C2Q1S6HCS7Y9TBQ2PJ2NAM","skill-creator","Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fclaude\u002Fskills\u002Fsynced\u002Ffcfa9261-0073-49cb-8312-19eea68f0c58_391f3767-a35d-4280-81a1-363cd861a8e6\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fclaude\u002Fskills\u002Fsynced\u002Ffcfa9261-0073-49cb-8312-19eea68f0c58_391f3767-a35d-4280-81a1-363cd861a8e6\u002Fskill-creator\u002FSKILL.md",[114],{"categoryNo":115,"categoryName":116,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[118,119,120,121,122,123,124,125,126,56,127,128,38,129,130,131,132,133,134,39,135],"skill creator","creator","performance","run evals","test","variance analysis","create","run","benchmark","improve","edit","evals","optimize","existing skill","for","accuracy","scratch","new",{"skillNo":137,"name":138,"nameZh":6,"description":139,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":110,"licenseFileUrl":6,"sourceHtmlUrl":140,"categories":141,"keywords":142,"publishedAt":62},"01M6C2ZRGJ9HN4N9BP24DPNCR4","returns-reverse-logistics","Codified expertise for returns authorization, receipt and inspection, disposition decisions, refund processing, fraud detection, and warranty claims management. Informed by returns operations managers with 15+ years experience. Includes grading frameworks, disposition economics, fraud pattern recognition, and vendor recovery processes. Use when handling product returns, reverse logistics, refund decisions, return fraud detection, or warranty claims.","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fopencode_home\u002Fskills\u002Freturns-reverse-logistics\u002FSKILL.md",[],[143,144,145,146,147,148,59,149,150,151,152,153,154,155,156,157,38,158,159,160,161,162,163,164,165,166,132,167,168,39,169],"returns","returns reverse logistics","reverse logistics","reverse","github","code","https","authorization","detection","fraud","recovery","decisions","management","operations","vendor","claims management","frameworks","fraud detection","pattern","grading","processing","economics","managers","claims","expertise","refund","inspection",{"skillNo":171,"name":172,"nameZh":6,"description":173,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":110,"licenseFileUrl":6,"sourceHtmlUrl":174,"categories":175,"keywords":176,"publishedAt":62},"01M6C2ZGWSNZGZZQ5VCFWHD2QT","quality-nonconformance","Codified expertise for quality control, non-conformance investigation, root cause analysis, corrective action, and supplier quality management in regulated manufacturing. Informed by quality engineers with 15+ years experience across FDA, IATF 16949, and AS9100 environments. Includes NCR lifecycle management, CAPA systems, SPC interpretation, and audit methodology. Use when investigating non-conformances, performing root cause analysis, managing CAPAs, interpreting SPC data, or handling supplier quality issues.","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fopencode_home\u002Fskills\u002Fquality-nonconformance\u002FSKILL.md",[],[177,178,147,179,180,148,181,149,182,57,183,184,56,185,155,38,186,187,188,189,190,191,192,193,132,167,194,39],"quality","quality nonconformance","root cause analysis","interpretation","issues","audit","methodology","lifecycle","investigation","fda","across","manufacturing","environments","corrective action","supplier quality management","action","conformance","root cause",{"skillNo":196,"name":197,"nameZh":6,"description":198,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":110,"licenseFileUrl":6,"sourceHtmlUrl":199,"categories":200,"keywords":201,"publishedAt":62},"01M6C2Z8VQ9AYZYKPZW1KD9DX5","production-scheduling","Codified expertise for production scheduling, job sequencing, line balancing, changeover optimization, and bottleneck resolution in discrete and batch manufacturing. Informed by production schedulers with 15+ years experience. Includes TOC\u002Fdrum-buffer-rope, SMED, OEE analysis, disruption response frameworks, and ERP\u002FMES interaction patterns. Use when scheduling production, resolving bottlenecks, optimizing changeovers, responding to disruptions, or balancing manufacturing lines.","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fopencode_home\u002Fskills\u002Fproduction-scheduling\u002FSKILL.md",[],[202,203,204,147,148,205,149,206,56,207,208,38,209,210,159,211,212,213,188,214,132,167,39],"Production","production scheduling","scheduling","batch","Optimization","erp","bottleneck","toc","patterns","line","interaction","sequencing","buffer",{"skillNo":216,"name":217,"nameZh":6,"description":218,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":110,"licenseFileUrl":6,"sourceHtmlUrl":219,"categories":220,"keywords":221,"publishedAt":62},"01M6C2YR01NNN2Z1G18RN7F9MP","logistics-exception-management","Codified expertise for handling freight exceptions, shipment delays, damages, losses, and carrier disputes. Informed by logistics professionals with 15+ years operational experience. Includes escalation protocols, carrier-specific behaviors, claims procedures, and judgment frameworks. Use when handling shipping exceptions, freight claims, delivery issues, or carrier disputes.","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fopencode_home\u002Fskills\u002Flogistics-exception-management\u002FSKILL.md",[],[155,222,147,148,223,181,224,149,225,38,159,226,227,228,229,166,132,167,230,39],"logistics exception management","shipping","protocols","escalation","delivery","claude-code","judgment","with","freight",{"skillNo":232,"name":233,"nameZh":6,"description":234,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":110,"licenseFileUrl":6,"sourceHtmlUrl":235,"categories":236,"keywords":237,"publishedAt":62},"01M6C2YC5PXTEJYBJJQZVXPQS0","inventory-demand-planning","Codified expertise for demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation at multi-location retailers. Informed by demand planners with 15+ years experience managing hundreds of SKUs. Includes forecasting method selection, ABC\u002FXYZ analysis, seasonal transition management, and vendor negotiation frameworks. Use when forecasting demand, setting safety stock, planning replenishment, managing promotions, or optimizing inventory levels.","https:\u002F\u002Fgithub.com\u002Fnoirelab\u002Flinux-setup\u002Fblob\u002Fmain\u002Fconfigs\u002Fcommon\u002Fopencode_home\u002Fskills\u002Finventory-demand-planning\u002FSKILL.md",[],[238,239,240,241,147,148,149,242,206,243,56,155,157,244,38,245,159,246,247,248,249,250,132,167,251,39],"planning","inventory","inventory demand planning","demand planning","negotiation","Safety","forecasting","selection","estimation","stock","seasonal","lift","at","transition"]