{ "schemaVersion": "1.0", "item": { "slug": "product-research", "name": "Product Research", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/h4gen/product-research", "canonicalUrl": "https://clawhub.ai/h4gen/product-research", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/product-research", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=product-research", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "references/inspected-skills.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/product-research" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/product-research", "agentPageUrl": "https://openagent3.xyz/skills/product-research/agent", "manifestUrl": "https://openagent3.xyz/skills/product-research/agent.json", "briefUrl": "https://openagent3.xyz/skills/product-research/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Purpose", "body": "Identify product opportunities by combining:\n\nsocial momentum,\nregional demand checks,\nmarketplace competition/sales signals,\nstore deployment readiness.\n\nThis is an orchestration skill. It does not guarantee profitability." }, { "title": "Required Installed Skills", "body": "tavily-search (inspected latest: 1.0.0)\ngoplaces (inspected latest: 1.0.0)\napi-gateway (inspected latest: 1.0.29)\nDeployment target:\n\nwoocommerce via api-gateway (supported), or\nshopify (inspected latest 1.0.1, currently under maintenance)\n\nInstall/update:\n\nnpx -y clawhub@latest install tavily-search\nnpx -y clawhub@latest install goplaces\nnpx -y clawhub@latest install api-gateway\nnpx -y clawhub@latest install shopify\nnpx -y clawhub@latest update --all\n\nVerify:\n\nnpx -y clawhub@latest list" }, { "title": "Required Credentials", "body": "TAVILY_API_KEY (trend and web data collection)\nGOOGLE_PLACES_API_KEY (regional demand proxy via goplaces)\nMATON_API_KEY (market/deployment APIs via api-gateway)\n\nPreflight:\n\necho \"$TAVILY_API_KEY\" | wc -c\necho \"$GOOGLE_PLACES_API_KEY\" | wc -c\necho \"$MATON_API_KEY\" | wc -c\n\nMandatory behavior:\n\nNever fail silently on missing keys.\nAlways return MissingAPIKeys with missing variables and blocked stages.\nContinue with non-blocked stages and mark output as Partial when needed." }, { "title": "Inputs the LM Must Collect First", "body": "product_niche (example: pets)\ntarget_region (country/city scope)\ntarget_store (woocommerce or shopify)\nrisk_tolerance (low, medium, high)\nmax_cogs (maximum source cost)\nmin_margin_target (percentage)\nshipping_time_limit_days\nad_angle (problem-solution, UGC demo, before-after)\n\nDo not propose deployment before constraints are explicit." }, { "title": "tavily-search", "body": "Use for trend and sourcing discovery:\n\nfind viral product mentions and trend lists,\ngather social evidence summaries,\nlocate supplier listings (AliExpress/Alibaba/web catalogs),\nextract competitor storefront/product page signals." }, { "title": "goplaces", "body": "Use for regional demand proxy checks:\n\nquery related local businesses/search entities,\ncompare demand-like signals across cities/regions,\nsupport geo-prioritization for launch/testing.\n\nImportant limitation:\n\ngoplaces is a Places API interface, not direct social trend telemetry.\nTreat it as location demand context, not a standalone trend oracle." }, { "title": "api-gateway", "body": "Use for structured market and store operations when connections exist:\n\nmarketplace/analytics connectors if available in user account,\nWooCommerce product draft creation,\noptional Search Console-like enrichment if connected.\n\nOperational constraints from inspected skill:\n\nrequires MATON_API_KEY\nrequires active per-app OAuth connections (ctrl.maton.ai)\nAPI key alone is not sufficient\n\nCapability disclosure:\n\nwoocommerce is explicitly listed in inspected api-gateway references.\nshopify inspected skill is currently under maintenance and may be unavailable.\nhelium 10 and jungle scout are not explicitly listed as native api-gateway app names in the inspected version." }, { "title": "Canonical Causal Signal Chain", "body": "Trend Scan (tavily-search)\n\ndiscover products with strong recent social momentum.\ncandidate example pattern: \"TikTok made me buy it\" + niche + last 7 days.\n\nSocial Evidence Scoring\n\nscore each candidate by recency, source diversity, and repeat mention frequency.\nrequire at least 2 independent sources for shortlisting.\n\nRegional Demand Check (goplaces)\n\ncheck target-region relevance proxies.\nprioritize products with cross-region consistency, not one-off spikes.\n\nMarket Data Gate (api-gateway)\n\nattempt sales/competition metrics via connected provider.\nif Helium 10/Jungle Scout path is unavailable, trigger explicit gate message and fallback mode.\n\nRequired gate format:\n\nDataGateStatus: available or blocked\nReason: missing key / missing connection / provider unsupported\nAction: exact remediation steps and link\n\nIf user requests Helium 10 discount onboarding:\n\ninclude user-provided affiliate URL when available,\notherwise use placeholder explicitly as user action item: [HELIUM10_LINK_OR_COUPON].\n\nIf user requests Jungle Scout onboarding:\n\ninclude user-provided affiliate URL when available,\notherwise use placeholder: [JUNGLESCOUT_LINK_OR_COUPON].\n\nSourcing Check (tavily-search)\n\nfind supplier options,\ncompare estimated COGS and shipping windows,\nflag risky supplier signals (unclear shipping, no ratings, poor consistency).\n\nDeployment\n\nWooCommerce path: create product draft via api-gateway woocommerce endpoints.\nShopify path: if unavailable/maintenance, emit blocked deployment status and WooCommerce/manual fallback package.\n\nCreative Output\n\ngenerate product listing copy,\ngenerate one TikTok ad script matched to selected angle." }, { "title": "Output Contract", "body": "Always return:\n\nTrendCandidates\n\nshortlisted products\nevidence score and sources\n\n\n\nMarketCheck\n\ncompetition/sales insight\nDataGate status and provider path used\n\n\n\nSourcingTable\n\nsupplier options\nestimated COGS\nshipping-time estimate\nrisk notes\n\n\n\nStoreDraft\n\ntitle\nproduct description\nkey benefits\nprice suggestion\ndraft payload for woocommerce or shopify (if available)\n\n\n\nTikTokAdScript\n\nhook (first 2 seconds)\ndemo beats\nCTA\n\n\n\nNextActions\n\nexact steps to publish and test" }, { "title": "Quality Gates", "body": "Before final output, verify:\n\ntrend evidence is recent and source-backed\nproduct economics satisfy user constraints\ndeployment path is real (not assumed)\nunsupported integrations are explicitly disclosed\nmissing keys/connections are clearly reported\n\nIf any gate fails, return Needs Revision with missing evidence/dependency list." }, { "title": "Failure Handling", "body": "Missing TAVILY_API_KEY: return MissingAPIKeys, skip trend/sourcing web stages, ask for seed product URLs.\nMissing GOOGLE_PLACES_API_KEY: return MissingAPIKeys, skip regional-demand stage.\nMissing MATON_API_KEY: return MissingAPIKeys, skip gateway market/deployment stages.\nMissing api-gateway app connection (HTTP 400): keep pipeline running in analysis mode and provide connection setup steps.\nShopify unavailable (maintenance): mark deployment as blocked and provide WooCommerce/manual import fallback.\nHelium 10/Jungle Scout unavailable via gateway: disclose unsupported provider path and continue with proxy competition analysis." }, { "title": "Guardrails", "body": "Never claim a product is guaranteed to win.\nNever fabricate sales volume, margins, or review counts.\nNever hide blocked provider paths.\nKeep recommendations tied to observed evidence and declared assumptions." } ], "body": "Purpose\n\nIdentify product opportunities by combining:\n\nsocial momentum,\nregional demand checks,\nmarketplace competition/sales signals,\nstore deployment readiness.\n\nThis is an orchestration skill. It does not guarantee profitability.\n\nRequired Installed Skills\ntavily-search (inspected latest: 1.0.0)\ngoplaces (inspected latest: 1.0.0)\napi-gateway (inspected latest: 1.0.29)\nDeployment target:\nwoocommerce via api-gateway (supported), or\nshopify (inspected latest 1.0.1, currently under maintenance)\n\nInstall/update:\n\nnpx -y clawhub@latest install tavily-search\nnpx -y clawhub@latest install goplaces\nnpx -y clawhub@latest install api-gateway\nnpx -y clawhub@latest install shopify\nnpx -y clawhub@latest update --all\n\n\nVerify:\n\nnpx -y clawhub@latest list\n\nRequired Credentials\nTAVILY_API_KEY (trend and web data collection)\nGOOGLE_PLACES_API_KEY (regional demand proxy via goplaces)\nMATON_API_KEY (market/deployment APIs via api-gateway)\n\nPreflight:\n\necho \"$TAVILY_API_KEY\" | wc -c\necho \"$GOOGLE_PLACES_API_KEY\" | wc -c\necho \"$MATON_API_KEY\" | wc -c\n\n\nMandatory behavior:\n\nNever fail silently on missing keys.\nAlways return MissingAPIKeys with missing variables and blocked stages.\nContinue with non-blocked stages and mark output as Partial when needed.\nInputs the LM Must Collect First\nproduct_niche (example: pets)\ntarget_region (country/city scope)\ntarget_store (woocommerce or shopify)\nrisk_tolerance (low, medium, high)\nmax_cogs (maximum source cost)\nmin_margin_target (percentage)\nshipping_time_limit_days\nad_angle (problem-solution, UGC demo, before-after)\n\nDo not propose deployment before constraints are explicit.\n\nTool Responsibilities\ntavily-search\n\nUse for trend and sourcing discovery:\n\nfind viral product mentions and trend lists,\ngather social evidence summaries,\nlocate supplier listings (AliExpress/Alibaba/web catalogs),\nextract competitor storefront/product page signals.\ngoplaces\n\nUse for regional demand proxy checks:\n\nquery related local businesses/search entities,\ncompare demand-like signals across cities/regions,\nsupport geo-prioritization for launch/testing.\n\nImportant limitation:\n\ngoplaces is a Places API interface, not direct social trend telemetry.\nTreat it as location demand context, not a standalone trend oracle.\napi-gateway\n\nUse for structured market and store operations when connections exist:\n\nmarketplace/analytics connectors if available in user account,\nWooCommerce product draft creation,\noptional Search Console-like enrichment if connected.\n\nOperational constraints from inspected skill:\n\nrequires MATON_API_KEY\nrequires active per-app OAuth connections (ctrl.maton.ai)\nAPI key alone is not sufficient\n\nCapability disclosure:\n\nwoocommerce is explicitly listed in inspected api-gateway references.\nshopify inspected skill is currently under maintenance and may be unavailable.\nhelium 10 and jungle scout are not explicitly listed as native api-gateway app names in the inspected version.\nCanonical Causal Signal Chain\nTrend Scan (tavily-search)\ndiscover products with strong recent social momentum.\ncandidate example pattern: \"TikTok made me buy it\" + niche + last 7 days.\nSocial Evidence Scoring\nscore each candidate by recency, source diversity, and repeat mention frequency.\nrequire at least 2 independent sources for shortlisting.\nRegional Demand Check (goplaces)\ncheck target-region relevance proxies.\nprioritize products with cross-region consistency, not one-off spikes.\nMarket Data Gate (api-gateway)\nattempt sales/competition metrics via connected provider.\nif Helium 10/Jungle Scout path is unavailable, trigger explicit gate message and fallback mode.\n\nRequired gate format:\n\nDataGateStatus: available or blocked\nReason: missing key / missing connection / provider unsupported\nAction: exact remediation steps and link\n\nIf user requests Helium 10 discount onboarding:\n\ninclude user-provided affiliate URL when available,\notherwise use placeholder explicitly as user action item: [HELIUM10_LINK_OR_COUPON].\n\nIf user requests Jungle Scout onboarding:\n\ninclude user-provided affiliate URL when available,\notherwise use placeholder: [JUNGLESCOUT_LINK_OR_COUPON].\nSourcing Check (tavily-search)\nfind supplier options,\ncompare estimated COGS and shipping windows,\nflag risky supplier signals (unclear shipping, no ratings, poor consistency).\nDeployment\nWooCommerce path: create product draft via api-gateway woocommerce endpoints.\nShopify path: if unavailable/maintenance, emit blocked deployment status and WooCommerce/manual fallback package.\nCreative Output\ngenerate product listing copy,\ngenerate one TikTok ad script matched to selected angle.\nOutput Contract\n\nAlways return:\n\nTrendCandidates\n\nshortlisted products\nevidence score and sources\n\nMarketCheck\n\ncompetition/sales insight\nDataGate status and provider path used\n\nSourcingTable\n\nsupplier options\nestimated COGS\nshipping-time estimate\nrisk notes\n\nStoreDraft\n\ntitle\nproduct description\nkey benefits\nprice suggestion\ndraft payload for woocommerce or shopify (if available)\n\nTikTokAdScript\n\nhook (first 2 seconds)\ndemo beats\nCTA\n\nNextActions\n\nexact steps to publish and test\nQuality Gates\n\nBefore final output, verify:\n\ntrend evidence is recent and source-backed\nproduct economics satisfy user constraints\ndeployment path is real (not assumed)\nunsupported integrations are explicitly disclosed\nmissing keys/connections are clearly reported\n\nIf any gate fails, return Needs Revision with missing evidence/dependency list.\n\nFailure Handling\nMissing TAVILY_API_KEY: return MissingAPIKeys, skip trend/sourcing web stages, ask for seed product URLs.\nMissing GOOGLE_PLACES_API_KEY: return MissingAPIKeys, skip regional-demand stage.\nMissing MATON_API_KEY: return MissingAPIKeys, skip gateway market/deployment stages.\nMissing api-gateway app connection (HTTP 400): keep pipeline running in analysis mode and provide connection setup steps.\nShopify unavailable (maintenance): mark deployment as blocked and provide WooCommerce/manual import fallback.\nHelium 10/Jungle Scout unavailable via gateway: disclose unsupported provider path and continue with proxy competition analysis.\nGuardrails\nNever claim a product is guaranteed to win.\nNever fabricate sales volume, margins, or review counts.\nNever hide blocked provider paths.\nKeep recommendations tied to observed evidence and declared assumptions." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/h4gen/product-research", "publisherUrl": "https://clawhub.ai/h4gen/product-research", "owner": "h4gen", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/product-research", "downloadUrl": "https://openagent3.xyz/downloads/product-research", "agentUrl": "https://openagent3.xyz/skills/product-research/agent", "manifestUrl": "https://openagent3.xyz/skills/product-research/agent.json", "briefUrl": "https://openagent3.xyz/skills/product-research/agent.md" } }