{"id":"9bc096bb-b520-49d3-92ed-9e392d3e3241","shortId":"pZ9hn6","kind":"skill","title":"apify-ecommerce","tagline":"Extract product data, prices, reviews, and seller information from any e-commerce platform using Apify's E-commerce Scraping Tool.","description":"# E-commerce Data Extraction\n\nExtract product data, prices, reviews, and seller information from any e-commerce platform using Apify's E-commerce Scraping Tool.\n\n## When to Use\n- You need product, pricing, review, stock, or seller data from e-commerce sites.\n- The task involves price monitoring, competitor product comparison, MAP enforcement, or review analysis.\n- You need a guided workflow for extracting marketplace data and summarizing findings.\n\n## Prerequisites\n\n- `.env` file with `APIFY_TOKEN` (at `~/.claude/.env`)\n- Node.js 20.6+ (for native `--env-file` support)\n\n## Workflow Selection\n\n| User Need | Workflow | Best For |\n|-----------|----------|----------|\n| Track prices, compare products | Workflow 1: Products & Pricing | Price monitoring, MAP compliance, competitor analysis. Add AI summary for insights. |\n| Analyze reviews (sentiment or quality) | Workflow 2: Reviews | Brand perception, customer sentiment, quality issues, defect patterns |\n| Find sellers across stores | Workflow 3: Sellers | Unauthorized resellers, vendor discovery via Google Shopping |\n\n## Progress Tracking\n\n```\nTask Progress:\n- [ ] Step 1: Select workflow and determine data source\n- [ ] Step 2: Configure Actor input\n- [ ] Step 3: Ask user preferences (format, filename)\n- [ ] Step 4: Run the extraction script\n- [ ] Step 5: Summarize results\n```\n\n---\n\n## Workflow 1: Products & Pricing\n\n**Use case:** Extract product data, prices, and stock status. Track competitor prices, detect MAP violations, benchmark products, or research markets.\n\n**Best for:** Pricing analysts, product managers, market researchers.\n\n### Input Options\n\n| Input Type | Field | Description |\n|------------|-------|-------------|\n| Product URLs | `detailsUrls` | Direct URLs to product pages (use object format) |\n| Category URLs | `listingUrls` | URLs to category/search result pages |\n| Keyword Search | `keyword` + `marketplaces` | Search term across selected marketplaces |\n\n### Example - Product URLs\n```json\n{\n  \"detailsUrls\": [\n    {\"url\": \"https://www.amazon.com/dp/B09V3KXJPB\"},\n    {\"url\": \"https://www.walmart.com/ip/123456789\"}\n  ],\n  \"additionalProperties\": true\n}\n```\n\n### Example - Keyword Search\n```json\n{\n  \"keyword\": \"Samsung Galaxy S24\",\n  \"marketplaces\": [\"www.amazon.com\", \"www.walmart.com\"],\n  \"additionalProperties\": true,\n  \"maxProductResults\": 50\n}\n```\n\n### Optional: AI Summary\n\nAdd these fields to get AI-generated insights:\n\n| Field | Description |\n|-------|-------------|\n| `fieldsToAnalyze` | Data points to analyze: `[\"name\", \"offers\", \"brand\", \"description\"]` |\n| `customPrompt` | Custom analysis instructions |\n\n**Example with AI summary:**\n```json\n{\n  \"keyword\": \"robot vacuum\",\n  \"marketplaces\": [\"www.amazon.com\"],\n  \"maxProductResults\": 50,\n  \"additionalProperties\": true,\n  \"fieldsToAnalyze\": [\"name\", \"offers\", \"brand\"],\n  \"customPrompt\": \"Summarize price range and identify top brands\"\n}\n```\n\n### Output Fields\n- `name` - Product name\n- `url` - Product URL\n- `offers.price` - Current price\n- `offers.priceCurrency` - Currency code (may vary by seller region)\n- `brand.slogan` - Brand name (nested in object)\n- `image` - Product image URL\n- Additional seller/stock info when `additionalProperties: true`\n\n> **Note:** Currency may vary in results even for US searches, as prices reflect different seller regions.\n\n---\n\n## Workflow 2: Customer Reviews\n\n**Use case:** Extract reviews for sentiment analysis, brand perception monitoring, or quality issue detection.\n\n**Best for:** Brand managers, customer experience teams, QA teams, product managers.\n\n### Input Options\n\n| Input Type | Field | Description |\n|------------|-------|-------------|\n| Product URLs | `reviewListingUrls` | Product pages to extract reviews from |\n| Keyword Search | `keywordReviews` + `marketplacesReviews` | Search for product reviews by keyword |\n\n### Example - Extract Reviews from Product\n```json\n{\n  \"reviewListingUrls\": [\n    {\"url\": \"https://www.amazon.com/dp/B09V3KXJPB\"}\n  ],\n  \"sortReview\": \"Most recent\",\n  \"additionalReviewProperties\": true,\n  \"maxReviewResults\": 500\n}\n```\n\n### Example - Keyword Search\n```json\n{\n  \"keywordReviews\": \"wireless earbuds\",\n  \"marketplacesReviews\": [\"www.amazon.com\"],\n  \"sortReview\": \"Most recent\",\n  \"additionalReviewProperties\": true,\n  \"maxReviewResults\": 200\n}\n```\n\n### Sort Options\n- `Most recent` - Latest reviews first (recommended)\n- `Most relevant` - Platform default relevance\n- `Most helpful` - Highest voted reviews\n- `Highest rated` - 5-star reviews first\n- `Lowest rated` - 1-star reviews first\n\n> **Note:** The `sortReview: \"Lowest rated\"` option may not work consistently across all marketplaces. For quality analysis, collect a large sample and filter by rating in post-processing.\n\n### Quality Analysis Tips\n- Set high `maxReviewResults` for statistical significance\n- Look for recurring keywords: \"broke\", \"defect\", \"quality\", \"returned\"\n- Filter results by rating if sorting doesn't work as expected\n- Cross-reference with competitor products for benchmarking\n\n---\n\n## Workflow 3: Seller Intelligence\n\n**Use case:** Find sellers across stores, discover unauthorized resellers, evaluate vendor options.\n\n**Best for:** Brand protection teams, procurement, supply chain managers.\n\n> **Note:** This workflow uses Google Shopping to find sellers across stores. Direct seller profile URLs are not reliably supported.\n\n### Input Configuration\n```json\n{\n  \"googleShoppingSearchKeyword\": \"Nike Air Max 90\",\n  \"scrapeSellersFromGoogleShopping\": true,\n  \"countryCode\": \"us\",\n  \"maxGoogleShoppingSellersPerProduct\": 20,\n  \"maxGoogleShoppingResults\": 100\n}\n```\n\n### Options\n| Field | Description |\n|-------|-------------|\n| `googleShoppingSearchKeyword` | Product name to search |\n| `scrapeSellersFromGoogleShopping` | Set to `true` to extract sellers |\n| `scrapeProductsFromGoogleShopping` | Set to `true` to also extract product details |\n| `countryCode` | Target country (e.g., `us`, `uk`, `de`) |\n| `maxGoogleShoppingSellersPerProduct` | Max sellers per product |\n| `maxGoogleShoppingResults` | Total result limit |\n\n---\n\n## Supported Marketplaces\n\n### Amazon (20+ regions)\n`www.amazon.com`, `www.amazon.co.uk`, `www.amazon.de`, `www.amazon.fr`, `www.amazon.it`, `www.amazon.es`, `www.amazon.ca`, `www.amazon.com.au`, `www.amazon.co.jp`, `www.amazon.in`, `www.amazon.com.br`, `www.amazon.com.mx`, `www.amazon.nl`, `www.amazon.pl`, `www.amazon.se`, `www.amazon.ae`, `www.amazon.sa`, `www.amazon.sg`, `www.amazon.com.tr`, `www.amazon.eg`\n\n### Major US Retailers\n`www.walmart.com`, `www.costco.com`, `www.costco.ca`, `www.homedepot.com`\n\n### European Retailers\n`allegro.pl`, `allegro.cz`, `allegro.sk`, `www.alza.cz`, `www.alza.sk`, `www.alza.de`, `www.alza.at`, `www.alza.hu`, `www.kaufland.de`, `www.kaufland.pl`, `www.kaufland.cz`, `www.kaufland.sk`, `www.kaufland.at`, `www.kaufland.fr`, `www.kaufland.it`, `www.cdiscount.com`\n\n### IKEA (40+ country/language combinations)\nSupports all major IKEA regional sites with multiple language options.\n\n### Google Shopping\nUse for seller discovery across multiple stores.\n\n---\n\n## Running the Extraction\n\n### Step 1: Set Skill Path\n```bash\nSKILL_PATH=~/.claude/skills/apify-ecommerce\n```\n\n### Step 2: Run Script\n\n**Quick answer (display in chat):**\n```bash\nnode --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \\\n  --actor \"apify/e-commerce-scraping-tool\" \\\n  --input 'JSON_INPUT'\n```\n\n**CSV export:**\n```bash\nnode --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \\\n  --actor \"apify/e-commerce-scraping-tool\" \\\n  --input 'JSON_INPUT' \\\n  --output YYYY-MM-DD_filename.csv \\\n  --format csv\n```\n\n**JSON export:**\n```bash\nnode --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \\\n  --actor \"apify/e-commerce-scraping-tool\" \\\n  --input 'JSON_INPUT' \\\n  --output YYYY-MM-DD_filename.json \\\n  --format json\n```\n\n### Step 3: Summarize Results\n\nReport:\n- Number of items extracted\n- File location (if exported)\n- Key insights based on workflow:\n  - **Products:** Price range, outliers, MAP violations\n  - **Reviews:** Average rating, sentiment trends, quality issues\n  - **Sellers:** Seller count, unauthorized sellers found\n\n---\n\n## Error Handling\n\n| Error | Solution |\n|-------|----------|\n| `APIFY_TOKEN not found` | Ensure `~/.claude/.env` contains `APIFY_TOKEN=your_token` |\n| `Actor not found` | Verify Actor ID: `apify/e-commerce-scraping-tool` |\n| `Run FAILED` | Check Apify console link in error output |\n| `Timeout` | Reduce `maxProductResults` or increase `--timeout` |\n| `No results` | Verify URLs are valid and accessible |\n| `Invalid marketplace` | Check marketplace value matches supported list exactly |\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["apify","ecommerce","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-apify-ecommerce","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/apify-ecommerce","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34964 github stars · SKILL.md body (8,967 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-25T00:50:27.560Z","embedding":null,"createdAt":"2026-04-18T21:31:17.011Z","updatedAt":"2026-04-25T00:50:27.560Z","lastSeenAt":"2026-04-25T00:50:27.560Z","tsv":"'/.claude/.env':102,782,797,816,874 '/.claude/skills/apify-ecommerce':767 '/dp/b09v3kxjpb':275,465 '/ip/123456789':279 '1':123,172,202,515,760 '100':642 '2':143,180,402,769 '20':640,686 '20.6':104 '200':488 '3':158,185,584,829 '4':192 '40':734 '5':198,509 '50':296,335 '500':472 '90':634 'access':909 'across':155,264,529,591,617,753 'actor':182,785,800,819,880,884 'add':132,300 'addit':379 'additionalproperti':280,293,336,383 'additionalreviewproperti':469,485 'ai':133,298,306,326 'ai-gener':305 'air':632 'allegro.cz':718 'allegro.pl':717 'allegro.sk':719 'also':663 'amazon':685 'analysi':82,131,322,411,534,548 'analyst':228 'analyz':137,315 'answer':773 'apifi':2,19,46,99,869,876,890 'apify-ecommerc':1 'apify/e-commerce-scraping-tool':786,801,820,886 'ask':186,952 'averag':853 'base':843 'bash':764,777,792,811 'benchmark':220,582 'best':116,225,419,599 'boundari':960 'brand':145,318,341,349,370,412,421,601 'brand.slogan':369 'broke':560 'case':206,406,588 'categori':250 'category/search':255 'chain':606 'chat':776 'check':889,912 'clarif':954 'clear':927 'code':363 'collect':535 'combin':736 'commerc':16,23,28,43,50,68 'compar':120 'comparison':77 'competitor':75,130,215,579 'complianc':129 'configur':181,628 'consist':528 'consol':891 'contain':875 'count':861 'countri':669 'country/language':735 'countrycod':637,667 'criteria':963 'cross':576 'cross-refer':575 'csv':790,808 'currenc':362,386 'current':359 'custom':147,321,403,423 'customprompt':320,342 'data':6,29,33,64,91,177,209,312 'de':673 'default':500 'defect':151,561 'describ':931 'descript':238,310,319,435,645 'detail':666 'detailsurl':241,271 'detect':217,418 'determin':176 'differ':398 'direct':242,619 'discov':593 'discoveri':163,752 'display':774 'doesn':570 'e':15,22,27,42,49,67 'e-commerc':14,21,26,41,48,66 'e.g':670 'earbud':479 'ecommerc':3 'enforc':79 'ensur':873 'env':96,108,780,795,814 'env-fil':107,779,794,813 'environ':943 'environment-specif':942 'error':865,867,894 'european':715 'evalu':596 'even':391 'exact':918 'exampl':267,282,324,455,473 'expect':574 'experi':424 'expert':948 'export':791,810,840 'extract':4,30,31,89,195,207,407,442,456,656,664,758,836 'fail':888 'field':237,302,309,351,434,644 'fieldstoanalyz':311,338 'file':97,109,781,796,815,837 'filenam':190 'filter':540,564 'find':94,153,589,615 'first':495,512,518 'format':189,249,807,826 'found':864,872,882 'galaxi':288 'generat':307 'get':304 'googl':165,612,747 'googleshoppingsearchkeyword':630,646 'guid':86 'handl':866 'help':503 'high':551 'highest':504,507 'id':885 'identifi':347 'ikea':733,740 'imag':375,377 'increas':900 'info':381 'inform':11,38 'input':183,233,235,430,432,627,787,789,802,804,821,823,957 'insight':136,308,842 'instruct':323 'intellig':586 'invalid':910 'involv':72 'issu':150,417,858 'item':835 'json':270,285,328,460,476,629,788,803,809,822,827 'key':841 'keyword':258,260,283,286,329,445,454,474,559 'keywordreview':447,477 'languag':745 'larg':537 'latest':493 'limit':682,919 'link':892 'list':917 'listingurl':252 'locat':838 'look':556 'lowest':513,522 'major':708,739 'manag':230,422,429,607 'map':78,128,218,850 'market':224,231 'marketplac':90,261,266,290,332,531,684,911,913 'marketplacesreview':448,480 'match':915,928 'max':633,675 'maxgoogleshoppingresult':641,679 'maxgoogleshoppingsellersperproduct':639,674 'maxproductresult':295,334,898 'maxreviewresult':471,487,552 'may':364,387,525 'miss':965 'monitor':74,127,414 'multipl':744,754 'name':316,339,352,354,371,648 'nativ':106 'need':57,84,114 'nest':372 'nike':631 'node':778,793,812 'node.js':103 'note':385,519,608 'number':833 'object':248,374 'offer':317,340 'offers.price':358 'offers.pricecurrency':361 'option':234,297,431,490,524,598,643,746 'outlier':849 'output':350,805,824,895,937 'page':246,257,440 'path':763,766 'path/reference/scripts/run_actor.js':784,799,818 'pattern':152 'per':677 'percept':146,413 'permiss':958 'platform':17,44,499 'point':313 'post':545 'post-process':544 'prefer':188 'prerequisit':95 'price':7,34,59,73,119,125,126,204,210,216,227,344,360,396,847 'process':546 'procur':604 'product':5,32,58,76,121,124,203,208,221,229,239,245,268,353,356,376,428,436,439,451,459,580,647,665,678,846 'profil':621 'progress':167,170 'protect':602 'qa':426 'qualiti':141,149,416,533,547,562,857 'quick':772 'rang':345,848 'rate':508,514,523,542,567,854 'recent':468,484,492 'recommend':496 'recur':558 'reduc':897 'refer':577 'reflect':397 'region':368,400,687,741 'relev':498,501 'reliabl':625 'report':832 'requir':956 'research':223,232 'resel':161,595 'result':200,256,390,565,681,831,903 'retail':710,716 'return':563 'review':8,35,60,81,138,144,404,408,443,452,457,494,506,511,517,852,949 'reviewlistingurl':438,461 'robot':330 'run':193,756,770,887 's24':289 'safeti':959 'sampl':538 'samsung':287 'scope':930 'scrape':24,51 'scrapeproductsfromgoogleshop':658 'scrapesellersfromgoogleshop':635,651 'script':196,771 'search':259,262,284,394,446,449,475,650 'select':112,173,265 'seller':10,37,63,154,159,367,399,585,590,616,620,657,676,751,859,860,863 'seller/stock':380 'sentiment':139,148,410,855 'set':550,652,659,761 'shop':166,613,748 'signific':555 'site':69,742 'skill':762,765,783,798,817,922 'skill-apify-ecommerce' 'solut':868 'sort':489,569 'sortreview':466,482,521 'sourc':178 'source-sickn33' 'specif':944 'star':510,516 'statist':554 'status':213 'step':171,179,184,191,197,759,768,828 'stock':61,212 'stop':950 'store':156,592,618,755 'substitut':940 'success':962 'summar':93,199,343,830 'summari':134,299,327 'suppli':605 'support':110,626,683,737,916 'target':668 'task':71,169,926 'team':425,427,603 'term':263 'test':946 'timeout':896,901 'tip':549 'token':100,870,877,879 'tool':25,52 'top':348 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'total':680 'track':118,168,214 'treat':935 'trend':856 'true':281,294,337,384,470,486,636,654,661 'type':236,433 'uk':672 'unauthor':160,594,862 'url':240,243,251,253,269,272,276,355,357,378,437,462,622,905 'us':393,638,671,709 'use':18,45,55,205,247,405,587,611,749,920 'user':113,187 'vacuum':331 'valid':907,945 'valu':914 'vari':365,388 'vendor':162,597 'verifi':883,904 'via':164 'violat':219,851 'vote':505 'wireless':478 'work':527,572 'workflow':87,111,115,122,142,157,174,201,401,583,610,845 'www.alza.at':723 'www.alza.cz':720 'www.alza.de':722 'www.alza.hu':724 'www.alza.sk':721 'www.amazon.ae':703 'www.amazon.ca':694 'www.amazon.co.jp':696 'www.amazon.co.uk':689 'www.amazon.com':274,291,333,464,481,688 'www.amazon.com.au':695 'www.amazon.com.br':698 'www.amazon.com.mx':699 'www.amazon.com.tr':706 'www.amazon.com/dp/b09v3kxjpb':273,463 'www.amazon.de':690 'www.amazon.eg':707 'www.amazon.es':693 'www.amazon.fr':691 'www.amazon.in':697 'www.amazon.it':692 'www.amazon.nl':700 'www.amazon.pl':701 'www.amazon.sa':704 'www.amazon.se':702 'www.amazon.sg':705 'www.cdiscount.com':732 'www.costco.ca':713 'www.costco.com':712 'www.homedepot.com':714 'www.kaufland.at':729 'www.kaufland.cz':727 'www.kaufland.de':725 'www.kaufland.fr':730 'www.kaufland.it':731 'www.kaufland.pl':726 'www.kaufland.sk':728 'www.walmart.com':278,292,711 'www.walmart.com/ip/123456789':277 'yyyy-mm-dd_filename.csv':806 'yyyy-mm-dd_filename.json':825","prices":[{"id":"5f92ecc0-4bdd-4d0e-aaf0-813081954b72","listingId":"9bc096bb-b520-49d3-92ed-9e392d3e3241","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:31:17.011Z"}],"sources":[{"listingId":"9bc096bb-b520-49d3-92ed-9e392d3e3241","source":"github","sourceId":"sickn33/antigravity-awesome-skills/apify-ecommerce","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-ecommerce","isPrimary":false,"firstSeenAt":"2026-04-18T21:31:17.011Z","lastSeenAt":"2026-04-25T00:50:27.560Z"}],"details":{"listingId":"9bc096bb-b520-49d3-92ed-9e392d3e3241","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"apify-ecommerce","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34964,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"e5e2c411ec84337023e59ddceaa721c99f157124","skill_md_path":"skills/apify-ecommerce/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-ecommerce"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"apify-ecommerce","description":"Extract product data, prices, reviews, and seller information from any e-commerce platform using Apify's E-commerce Scraping Tool."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/apify-ecommerce"},"updatedAt":"2026-04-25T00:50:27.560Z"}}