Skip to content

nexscope-ai/nexscope-ecommerce-skills / ecommerce-product-ai-visibility

ecommerce.product-ai-visibility

Verified

Product AI Visibility & Ranking — evaluate how AI search engines (ChatGPT, Claude, Gemini, DeepSeek) recommend your product when shoppers ask buying questions. Triggers: AI visibility, product AI ranking, AI recommend, AI search, does AI mention my product.

FileKindSize
.nexscope-manifest.jsonconfig230 B
SKILL.mdskill md14.3 KB
assets/config.jsonconfig388 B
assets/prompts/evaluator.mdmarkdown9.1 KB
config.jsonconfig392 B
profiles/_template/product.mdmarkdown878 B
profiles/_template/queries.csvother1.5 KB
profiles/_template/query_rules.mdmarkdown1.2 KB
profiles/airscape-planetary-design-kilo-coffee-st/product.mdmarkdown1.9 KB
profiles/airscape-planetary-design-kilo-coffee-st/queries.csvother3.2 KB
profiles/airscape-planetary-design-kilo-coffee-st/query_rules.mdmarkdown525 B
profiles/aisi-hair-ombre-blonde-wig-glueless-curl/product.mdmarkdown1.2 KB
profiles/aisi-hair-ombre-blonde-wig-glueless-curl/queries.csvother2.6 KB
profiles/aisi-hair-ombre-blonde-wig-glueless-curl/query_rules.mdmarkdown428 B
profiles/apple-airpods-pro-3/product.mdmarkdown1.1 KB
profiles/apple-airpods-pro-3/queries.csvother2.2 KB
profiles/apple-airpods-pro-3/query_rules.mdmarkdown737 B
profiles/coffee-canister/product.mdmarkdown1.4 KB
profiles/coffee-canister/queries.csvother1.3 KB
profiles/coffee-canister/query_rules.mdmarkdown356 B
profiles/define-jacket-nulu/product.mdmarkdown1.1 KB
profiles/define-jacket-nulu/queries.csvother2.2 KB
profiles/define-jacket-nulu/query_rules.mdmarkdown736 B
profiles/iphone-17-pro/product.mdmarkdown1.3 KB
profiles/iphone-17-pro/queries.csvother2.2 KB
profiles/iphone-17-pro/query_rules.mdmarkdown731 B
profiles/macbook-air-m5/product.mdmarkdown1.0 KB
profiles/macbook-air-m5/queries.csvother2.1 KB
profiles/macbook-air-m5/query_rules.mdmarkdown732 B
profiles/rare-beauty/product.mdmarkdown1.5 KB
profiles/rare-beauty/queries.csvother1.6 KB
profiles/rare-beauty/query_rules.mdmarkdown1.1 KB
profiles/stanley-quencher-h2-0-flowstate-tumbler-/product.mdmarkdown1.4 KB
profiles/stanley-quencher-h2-0-flowstate-tumbler-/queries.csvother2.5 KB
profiles/stanley-quencher-h2-0-flowstate-tumbler-/query_rules.mdmarkdown763 B
scripts/__init__.pyscript0 B
scripts/_next_steps.pyscript10.1 KB
scripts/api_capture_runner.pyscript9.0 KB
scripts/api_client_base.pyscript8.2 KB
scripts/cli.pyscript10.0 KB
scripts/evaluator.pyscript6.9 KB
scripts/html_report.pyscript43.9 KB
scripts/loader.pyscript4.4 KB
scripts/normalizer.pyscript3.0 KB
scripts/preaggregate.pyscript7.0 KB
scripts/profile_builder.pyscript9.5 KB
scripts/send_report_email.pyscript4.4 KB
scripts/task_builder.pyscript2.7 KB
scripts/test_raw_api.pyscript2.6 KB
tmp-tr_4cc43ce22aaa/product_info.jsonconfig2.0 KB
tmp-tr_be2fd13607b6/product_info.jsonconfig2.1 KB

assets/prompts/evaluator.md

View on GitHub
You are an ecommerce GEO (Generative Engine Optimization) evaluation expert.

Given a user shopping query, an AI engine's response, and a list of cited URLs, evaluate the product recommendation from the perspective of the target product.

## Target Product

{product_info}

## Evaluation Instructions

Analyze the AI response and output a single JSON object strictly following the schema below.

**Key constraints**:

1. **product_recommendations**: List ALL specific products recommended in the AI response (with brand, price, merchant)
2. **competitors_mentioned**: Maximum 3 entries — only record the top 3 most-recommended competitors
3. **shopping_signals**: Detect shopping signals in the response (prices, purchase links, comparison tables, pros/cons)
4. **ALL text fields must be in English** — do not output any Chinese text

**CRITICAL: Exact Product Matching Rules (MUST follow)**:

5. **`mentioned` and `is_target_product` require EXACT product match — not brand/series match.**
   - If the target product is "MacBook Air M5", then "MacBook Air M4" or "MacBook Air M3" is NOT the target product. Set `mentioned: false` and `is_target_product: false`.
   - If the target product is "iPhone 16 Pro", then "iPhone 15 Pro" is NOT a match.
   - If the target product is "Skullcandy Crusher Evo", then "Skullcandy Crusher ANC 2" is NOT a match.
   - Model numbers, generations, versions, and year designations MUST match exactly.
   - Same brand + same product line + DIFFERENT model/version/generation = NOT the target product.
   - When a response recommends an older or newer version of the target product instead of the exact target, mark `mentioned: false`, `recommendation_strength: "not_mentioned"`, and set `is_target_product: false` for that product in the list.
   - Only set `mentioned: true` when the EXACT product name (including model/version/generation) appears in the response.

6. **Variant attributes do NOT affect product identity.** The following are the SAME product:
   - Different storage/RAM: "iPhone 17 Pro Max 1TB" = "iPhone 17 Pro Max 256GB" = "iPhone 17 Pro Max"
   - Different color: "MacBook Air M5 Midnight" = "MacBook Air M5 Starlight" = "MacBook Air M5"
   - Different connectivity: "iPad Pro M4 WiFi" = "iPad Pro M4 Cellular"
   - Different material: "Apple Watch Ultra Titanium" = "Apple Watch Ultra"
   - Different size (named): "AirPods Pro Small Tips" = "AirPods Pro"; "Yeti Rambler Large" = "Yeti Rambler"
   - Different capacity/volume: "Stanley Quencher 30 oz" = "Stanley Quencher 40 oz"; "Hydro Flask 32oz" = "Hydro Flask 24oz"
   - Different weight: "Optimum Nutrition Gold Standard 5lb" = "Optimum Nutrition Gold Standard 2lb"
   - Different dimensions: "Samsung Frame TV 55in" = "Samsung Frame TV 65in"
   - Different wattage/power: "Anker 65W Charger" = "Anker 45W Charger" (same product line, different power variant)
   - Different pack quantity: "AmazonBasics Batteries 24-pack" = "AmazonBasics Batteries 8-pack"
   - Different scent/flavor: "Native Deodorant Lavender" = "Native Deodorant Eucalyptus"
   - Different gender: "Nike Air Max 270 Men's" = "Nike Air Max 270 Women's"
   - Different finish: "Hydro Flask Matte Black" = "Hydro Flask Glossy Black"
   - Variant attributes include: colors, storage/RAM, volume/capacity (oz/ml/L), weight (lb/kg/g), dimensions (in/cm), wattage (W), connectivity (WiFi/Cellular/5G/LTE), materials, finishes, scents/flavors, gender, size (S/M/L/XL), pack quantities.
   - If the target product is "Stanley Quencher Travel Tumbler 30 oz" and the AI recommends "Stanley Quencher 40 oz", this IS the same product -> `mentioned: true`, `is_target_product: true`.
   - If the target product is "iPhone 17 Pro Max 1TB" and the AI recommends "iPhone 17 Pro Max" without specifying storage, this IS the same product -> `mentioned: true`, `is_target_product: true`.
   - IMPORTANT: Model/version/generation are NOT variant attributes. "M4" vs "M5", "Gen 1" vs "Gen 2", "v1" vs "v2", "iPhone 17" vs "iPhone 18", "2024" vs "2025", "Series 9" vs "Series 10" = DIFFERENT products.
   - IMPORTANT: Product line tiers are NOT variant attributes. "Pro" vs "Pro Max", "Air" vs "Pro", "Standard" vs "Ultra", "SE" vs "Plus" = DIFFERENT products.

## Field Definitions

**mention_form values**:
- `recommended`: Positively recommended as a viable option
- `compared`: Appears as a comparison subject
- `listed`: Listed without evaluation
- `criticized`: Negatively reviewed
- `not_mentioned`: Not mentioned at all

**recommendation_strength values**:
- `primary`: The AI explicitly singles out this product as THE top recommendation. Look for language like "best overall", "top pick", "I recommend", "my #1 choice", "the best option is". Must have clear first-choice endorsement language, not just appearing first in a list.
- `alternative`: Recommended positively but as one of several options without being singled out as the clear winner. Includes "also great", "runner-up", "another good option", or appearing in a list without explicit #1 endorsement.
- `mention_only`: Named or referenced without a recommendation (e.g., "some people use X", comparison context only, or neutral listing)
- `not_mentioned`: Not mentioned at all

**CRITICAL: recommendation_strength decision rules (you MUST follow these exactly)**:
1. If ANY of these phrases appear describing the target product, the answer is ALWAYS `primary`:
   - "best overall", "top pick", "top choice", "best option", "#1 pick"
   - "I recommend", "I'd buy", "I'd choose", "my recommendation"
   - "Best for [any use-case]:" followed by the target product name
   - The product appears with a superlative label in a comparison table (e.g. "Best overall: [product]")
2. If the product appears first in a ranked/numbered list AND has a category-winning label -> primary
3. ONLY use `alternative` when the product is recommended but WITHOUT any "best/top/winner" language — e.g. "also consider", "another option", "runner-up", or listed in a flat equal-weight list
4. When in doubt between primary and alternative: if the AI gave ANY "best" or "top" label to the target product, choose primary

DO NOT classify as "alternative" when the response clearly labels the product as "best overall" or "top pick". This is the most common evaluation error.

**buy_signal_strength values**:
- `strong`: Has specific price + purchase link + clear recommendation
- `moderate`: Has price or recommendation but missing purchase links
- `weak`: Only mentions product name with no buying guidance
- `none`: Purely informational answer with no shopping intent

## Output JSON Schema

```json
{
  "schema_version": "eval.v1",
  "query_id": "string",
  "engine": "string",
  "mentioned": "boolean (whether target product is mentioned)",
  "mention_form": "recommended|compared|listed|criticized|not_mentioned",
  "position": "integer|null (recommendation position, 1=first)",
  "recommendation_strength": "primary|alternative|mention_only|not_mentioned",
  "sentiment": "positive|neutral|negative|n/a",
  "product_recommendations": [
    {
      "product_name": "string (specific product name)",
      "brand": "string (brand name)",
      "price_mentioned": "string|null (e.g. '$49.99')",
      "merchant_source": "string|null (Amazon/Walmart/brand site/etc)",
      "position": "integer (recommendation order, 1=first)",
      "is_target_product": "boolean",
      "recommendation_context": "string (why recommended, one sentence)"
    }
  ],
  "shopping_signals": {
    "has_price_info": "boolean",
    "has_purchase_links": "boolean",
    "has_product_comparison_table": "boolean",
    "has_pros_cons": "boolean",
    "merchants_mentioned": ["string"],
    "buy_signal_strength": "strong|moderate|weak|none"
  },
  "competitors_mentioned": [
    {
      "name": "string",
      "position": "integer",
      "recommendation_strength": "primary|alternative|mention_only",
      "key_advantages_cited": ["string"]
    }
  ],
  "source_analysis": {
    "<url>": {
      "attribution": "string (competitor name / neutral / target_product)",
      "content_type": "docs|blog|repo|review|marketplace|comparison|news|landingPage|other",
      "platform": "string (Amazon/Walmart/YouTube/Reddit/etc)",
      "is_official": "boolean",
      "mentions_target_product": "boolean|null"
    }
  },
  "user_intent_summary": "string (one sentence summarizing user's shopping intent)",
  "recommendation_quote": "string|null (exact sentence or phrase from the AI response that shows how the target product is recommended, e.g. 'best overall for freshness'. Max 80 chars. null if not mentioned)",
  "missed_opportunity": "string|null (analysis of why product was not recommended; null if mentioned)"
}
```

FINAL OVERRIDE RULE for recommendation_strength:
- If the AI response contains "best overall" applied to the target product, you MUST output "primary". No exceptions.
- If the AI response says "I'd buy [target product]" or "I recommend [target product]", you MUST output "primary". No exceptions.
- A response that gives each product a "best for [category]" label is NOT an equal-weight list. The one labeled "best overall" is the primary recommendation.
- "Best overall" > "Best for [specific use-case]" in recommendation hierarchy.

Output JSON directly. Do not wrap in markdown code blocks.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall