{"id":"f6a69e9a-df7f-4105-b224-94cddfa43d15","shortId":"qtqaXE","kind":"skill","title":"apify-market-research","tagline":"Analyze market conditions, geographic opportunities, pricing, consumer behavior, and product validation across Google Maps, Facebook, Instagram, Booking.com, and TripAdvisor.","description":"# Market Research\n\nConduct market research using Apify Actors to extract data from multiple platforms.\n\n## When to Use\n- You need market sizing, regional demand, pricing, trend, or consumer behavior data.\n- The task is to gather research inputs from maps, travel, Facebook, Instagram, or trend sources with Apify.\n- You need structured market data plus a synthesized view of opportunities or risks.\n\n## Prerequisites\n(No need to check it upfront)\n\n- `.env` file with `APIFY_TOKEN`\n- Node.js 20.6+ (for native `--env-file` support)\n- `mcpc` CLI tool: `npm install -g @apify/mcpc`\n\n## Workflow\n\nCopy this checklist and track progress:\n\n```\nTask Progress:\n- [ ] Step 1: Identify market research type (select Actor)\n- [ ] Step 2: Fetch Actor schema via mcpc\n- [ ] Step 3: Ask user preferences (format, filename)\n- [ ] Step 4: Run the analysis script\n- [ ] Step 5: Summarize findings\n```\n\n### Step 1: Identify Market Research Type\n\nSelect the appropriate Actor based on research needs:\n\n| User Need | Actor ID | Best For |\n|-----------|----------|----------|\n| Market density | `compass/crawler-google-places` | Location analysis |\n| Geospatial analysis | `compass/google-maps-extractor` | Business mapping |\n| Regional interest | `apify/google-trends-scraper` | Trend data |\n| Pricing and demand | `apify/facebook-marketplace-scraper` | Market pricing |\n| Event market | `apify/facebook-events-scraper` | Event analysis |\n| Consumer needs | `apify/facebook-groups-scraper` | Group research |\n| Market landscape | `apify/facebook-pages-scraper` | Business pages |\n| Business density | `apify/facebook-page-contact-information` | Contact data |\n| Cultural insights | `apify/facebook-photos-scraper` | Visual research |\n| Niche targeting | `apify/instagram-hashtag-scraper` | Hashtag research |\n| Hashtag stats | `apify/instagram-hashtag-stats` | Market sizing |\n| Market activity | `apify/instagram-reel-scraper` | Activity analysis |\n| Market intelligence | `apify/instagram-scraper` | Full data |\n| Product launch research | `apify/instagram-api-scraper` | API access |\n| Hospitality market | `voyager/booking-scraper` | Hotel data |\n| Tourism insights | `maxcopell/tripadvisor-reviews` | Review analysis |\n\n### Step 2: Fetch Actor Schema\n\nFetch the Actor's input schema and details dynamically using mcpc:\n\n```bash\nexport $(grep APIFY_TOKEN .env | xargs) && mcpc --json mcp.apify.com --header \"Authorization: Bearer $APIFY_TOKEN\" tools-call fetch-actor-details actor:=\"ACTOR_ID\" | jq -r \".content\"\n```\n\nReplace `ACTOR_ID` with the selected Actor (e.g., `compass/crawler-google-places`).\n\nThis returns:\n- Actor description and README\n- Required and optional input parameters\n- Output fields (if available)\n\n### Step 3: Ask User Preferences\n\nBefore running, ask:\n1. **Output format**:\n   - **Quick answer** - Display top few results in chat (no file saved)\n   - **CSV** - Full export with all fields\n   - **JSON** - Full export in JSON format\n2. **Number of results**: Based on character of use case\n\n### Step 4: Run the Script\n\n**Quick answer (display in chat, no file):**\n```bash\nnode --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \\\n  --actor \"ACTOR_ID\" \\\n  --input 'JSON_INPUT'\n```\n\n**CSV:**\n```bash\nnode --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \\\n  --actor \"ACTOR_ID\" \\\n  --input 'JSON_INPUT' \\\n  --output YYYY-MM-DD_OUTPUT_FILE.csv \\\n  --format csv\n```\n\n**JSON:**\n```bash\nnode --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \\\n  --actor \"ACTOR_ID\" \\\n  --input 'JSON_INPUT' \\\n  --output YYYY-MM-DD_OUTPUT_FILE.json \\\n  --format json\n```\n\n### Step 5: Summarize Findings\n\nAfter completion, report:\n- Number of results found\n- File location and name\n- Key market insights\n- Suggested next steps (deeper analysis, validation)\n\n## Error Handling\n\n`APIFY_TOKEN not found` - Ask user to create `.env` with `APIFY_TOKEN=your_token`\n`mcpc not found` - Ask user to install `npm install -g @apify/mcpc`\n`Actor not found` - Check Actor ID spelling\n`Run FAILED` - Ask user to check Apify console link in error output\n`Timeout` - Reduce input size or increase `--timeout`\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","market","research","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-apify-market-research","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-market-research","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 (4,447 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.731Z","embedding":null,"createdAt":"2026-04-18T21:31:19.286Z","updatedAt":"2026-04-25T00:50:27.731Z","lastSeenAt":"2026-04-25T00:50:27.731Z","tsv":"'/reference/scripts/run_actor.js':386,403,424 '1':120,152,329 '2':128,254,355 '20.6':96 '3':135,322 '4':142,366 '5':148,436 'access':242 'across':16 'activ':228,230 'actor':31,126,130,160,167,256,260,289,291,292,298,303,308,387,388,404,405,425,426,486,490 'analysi':145,175,177,196,231,252,457 'analyz':5 'answer':333,371 'api':241 'apifi':2,30,69,93,272,282,461,471,499 'apify-market-research':1 'apify/facebook-events-scraper':194 'apify/facebook-groups-scraper':199 'apify/facebook-marketplace-scraper':189 'apify/facebook-page-contact-information':209 'apify/facebook-pages-scraper':204 'apify/facebook-photos-scraper':214 'apify/google-trends-scraper':183 'apify/instagram-api-scraper':240 'apify/instagram-hashtag-scraper':219 'apify/instagram-hashtag-stats':224 'apify/instagram-reel-scraper':229 'apify/instagram-scraper':234 'apify/mcpc':109,485 'appropri':159 'ask':136,323,328,465,478,495,545 'author':280 'avail':320 'base':161,359 'bash':269,377,394,415 'bearer':281 'behavior':12,51 'best':169 'booking.com':21 'boundari':553 'busi':179,205,207 'call':286 'case':364 'charact':361 'chat':339,374 'check':87,489,498 'checklist':113 'clarif':547 'claud':383,400,421 'clear':520 'cli':104 'compass/crawler-google-places':173,305 'compass/google-maps-extractor':178 'complet':440 'condit':7 'conduct':26 'consol':500 'consum':11,50,197 'contact':210 'content':296 'copi':111 'creat':468 'criteria':556 'csv':343,393,413 'cultur':212 'data':34,52,74,185,211,236,247 'deeper':456 'demand':46,188 'densiti':172,208 'describ':524 'descript':309 'detail':265,290 'display':334,372 'dynam':266 'e.g':304 'env':90,100,274,380,382,397,399,418,420,469 'env-fil':99,379,396,417 'environ':536 'environment-specif':535 'error':459,503 'event':192,195 'expert':541 'export':270,345,351 'extract':33 'facebook':19,63 'fail':494 'fetch':129,255,258,288 'fetch-actor-detail':287 'field':318,348 'file':91,101,341,376,381,398,419,446 'filenam':140 'find':150,438 'format':139,331,354,412,433 'found':445,464,477,488 'full':235,344,350 'g':108,484 'gather':57 'geograph':8 'geospati':176 'googl':17 'grep':271 'group':200 'handl':460 'hashtag':220,222 'header':279 'hospit':243 'hotel':246 'id':168,293,299,389,406,427,491 'identifi':121,153 'increas':510 'input':59,262,315,390,392,407,409,428,430,507,550 'insight':213,249,452 'instagram':20,64 'instal':107,481,483 'intellig':233 'interest':182 'jq':294 'json':277,349,353,391,408,414,429,434 'key':450 'landscap':203 'launch':238 'limit':512 'link':501 'locat':174,447 'map':18,61,180 'market':3,6,24,27,43,73,122,154,171,190,193,202,225,227,232,244,451 'match':521 'maxcopell/tripadvisor-reviews':250 'mcp.apify.com':278 'mcpc':103,133,268,276,475 'miss':558 'multipl':36 'name':449 'nativ':98 'need':42,71,85,164,166,198 'next':454 'nich':217 'node':378,395,416 'node.js':95 'npm':106,482 'number':356,442 'opportun':9,80 'option':314 'output':317,330,410,431,504,530 'page':206 'paramet':316 'permiss':551 'platform':37 'plugin':384,401,422 'plus':75 'prefer':138,325 'prerequisit':83 'price':10,47,186,191 'product':14,237 'progress':116,118 'quick':332,370 'r':295 'readm':311 'reduc':506 'region':45,181 'replac':297 'report':441 'requir':312,549 'research':4,25,28,58,123,155,163,201,216,221,239 'result':337,358,444 'return':307 'review':251,542 'risk':82 'root':385,402,423 'run':143,327,367,493 'safeti':552 'save':342 'schema':131,257,263 'scope':523 'script':146,369 'select':125,157,302 'size':44,226,508 'skill':515 'skill-apify-market-research' 'sourc':67 'source-sickn33' 'specif':537 'spell':492 'stat':223 'step':119,127,134,141,147,151,253,321,365,435,455 'stop':543 'structur':72 'substitut':533 'success':555 'suggest':453 'summar':149,437 'support':102 'synthes':77 'target':218 'task':54,117,519 'test':539 'timeout':505,511 'token':94,273,283,462,472,474 'tool':105,285 'tools-cal':284 'top':335 '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' 'tourism':248 'track':115 'travel':62 'treat':528 'trend':48,66,184 'tripadvisor':23 'type':124,156 'upfront':89 'use':29,40,267,363,513 'user':137,165,324,466,479,496 'valid':15,458,538 'via':132 'view':78 'visual':215 'voyager/booking-scraper':245 'workflow':110 'xarg':275 'yyyy-mm-dd_output_file.csv':411 'yyyy-mm-dd_output_file.json':432","prices":[{"id":"8a29ddd8-0659-4d55-a659-03b4180deec6","listingId":"f6a69e9a-df7f-4105-b224-94cddfa43d15","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:19.286Z"}],"sources":[{"listingId":"f6a69e9a-df7f-4105-b224-94cddfa43d15","source":"github","sourceId":"sickn33/antigravity-awesome-skills/apify-market-research","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-market-research","isPrimary":false,"firstSeenAt":"2026-04-18T21:31:19.286Z","lastSeenAt":"2026-04-25T00:50:27.731Z"}],"details":{"listingId":"f6a69e9a-df7f-4105-b224-94cddfa43d15","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"apify-market-research","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":"29fa780223fe225470bb86d079a4767226c16aad","skill_md_path":"skills/apify-market-research/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-market-research"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"apify-market-research","description":"Analyze market conditions, geographic opportunities, pricing, consumer behavior, and product validation across Google Maps, Facebook, Instagram, Booking.com, and TripAdvisor."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/apify-market-research"},"updatedAt":"2026-04-25T00:50:27.731Z"}}