# Send Product Research to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/product-research",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=product-research",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/inspected-skills.md"
    ],
    "downloadMode": "redirect",
    "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Purpose

Identify product opportunities by combining:

social momentum,
regional demand checks,
marketplace competition/sales signals,
store deployment readiness.

This is an orchestration skill. It does not guarantee profitability.

### Required Installed Skills

tavily-search (inspected latest: 1.0.0)
goplaces (inspected latest: 1.0.0)
api-gateway (inspected latest: 1.0.29)
Deployment target:

woocommerce via api-gateway (supported), or
shopify (inspected latest 1.0.1, currently under maintenance)

Install/update:

npx -y clawhub@latest install tavily-search
npx -y clawhub@latest install goplaces
npx -y clawhub@latest install api-gateway
npx -y clawhub@latest install shopify
npx -y clawhub@latest update --all

Verify:

npx -y clawhub@latest list

### Required Credentials

TAVILY_API_KEY (trend and web data collection)
GOOGLE_PLACES_API_KEY (regional demand proxy via goplaces)
MATON_API_KEY (market/deployment APIs via api-gateway)

Preflight:

echo "$TAVILY_API_KEY" | wc -c
echo "$GOOGLE_PLACES_API_KEY" | wc -c
echo "$MATON_API_KEY" | wc -c

Mandatory behavior:

Never fail silently on missing keys.
Always return MissingAPIKeys with missing variables and blocked stages.
Continue with non-blocked stages and mark output as Partial when needed.

### Inputs the LM Must Collect First

product_niche (example: pets)
target_region (country/city scope)
target_store (woocommerce or shopify)
risk_tolerance (low, medium, high)
max_cogs (maximum source cost)
min_margin_target (percentage)
shipping_time_limit_days
ad_angle (problem-solution, UGC demo, before-after)

Do not propose deployment before constraints are explicit.

### tavily-search

Use for trend and sourcing discovery:

find viral product mentions and trend lists,
gather social evidence summaries,
locate supplier listings (AliExpress/Alibaba/web catalogs),
extract competitor storefront/product page signals.

### goplaces

Use for regional demand proxy checks:

query related local businesses/search entities,
compare demand-like signals across cities/regions,
support geo-prioritization for launch/testing.

Important limitation:

goplaces is a Places API interface, not direct social trend telemetry.
Treat it as location demand context, not a standalone trend oracle.

### api-gateway

Use for structured market and store operations when connections exist:

marketplace/analytics connectors if available in user account,
WooCommerce product draft creation,
optional Search Console-like enrichment if connected.

Operational constraints from inspected skill:

requires MATON_API_KEY
requires active per-app OAuth connections (ctrl.maton.ai)
API key alone is not sufficient

Capability disclosure:

woocommerce is explicitly listed in inspected api-gateway references.
shopify inspected skill is currently under maintenance and may be unavailable.
helium 10 and jungle scout are not explicitly listed as native api-gateway app names in the inspected version.

### Canonical Causal Signal Chain

Trend Scan (tavily-search)

discover products with strong recent social momentum.
candidate example pattern: "TikTok made me buy it" + niche + last 7 days.

Social Evidence Scoring

score each candidate by recency, source diversity, and repeat mention frequency.
require at least 2 independent sources for shortlisting.

Regional Demand Check (goplaces)

check target-region relevance proxies.
prioritize products with cross-region consistency, not one-off spikes.

Market Data Gate (api-gateway)

attempt sales/competition metrics via connected provider.
if Helium 10/Jungle Scout path is unavailable, trigger explicit gate message and fallback mode.

Required gate format:

DataGateStatus: available or blocked
Reason: missing key / missing connection / provider unsupported
Action: exact remediation steps and link

If user requests Helium 10 discount onboarding:

include user-provided affiliate URL when available,
otherwise use placeholder explicitly as user action item: [HELIUM10_LINK_OR_COUPON].

If user requests Jungle Scout onboarding:

include user-provided affiliate URL when available,
otherwise use placeholder: [JUNGLESCOUT_LINK_OR_COUPON].

Sourcing Check (tavily-search)

find supplier options,
compare estimated COGS and shipping windows,
flag risky supplier signals (unclear shipping, no ratings, poor consistency).

Deployment

WooCommerce path: create product draft via api-gateway woocommerce endpoints.
Shopify path: if unavailable/maintenance, emit blocked deployment status and WooCommerce/manual fallback package.

Creative Output

generate product listing copy,
generate one TikTok ad script matched to selected angle.

### Output Contract

Always return:

TrendCandidates

shortlisted products
evidence score and sources



MarketCheck

competition/sales insight
DataGate status and provider path used



SourcingTable

supplier options
estimated COGS
shipping-time estimate
risk notes



StoreDraft

title
product description
key benefits
price suggestion
draft payload for woocommerce or shopify (if available)



TikTokAdScript

hook (first 2 seconds)
demo beats
CTA



NextActions

exact steps to publish and test

### Quality Gates

Before final output, verify:

trend evidence is recent and source-backed
product economics satisfy user constraints
deployment path is real (not assumed)
unsupported integrations are explicitly disclosed
missing keys/connections are clearly reported

If any gate fails, return Needs Revision with missing evidence/dependency list.

### Failure Handling

Missing TAVILY_API_KEY: return MissingAPIKeys, skip trend/sourcing web stages, ask for seed product URLs.
Missing GOOGLE_PLACES_API_KEY: return MissingAPIKeys, skip regional-demand stage.
Missing MATON_API_KEY: return MissingAPIKeys, skip gateway market/deployment stages.
Missing api-gateway app connection (HTTP 400): keep pipeline running in analysis mode and provide connection setup steps.
Shopify unavailable (maintenance): mark deployment as blocked and provide WooCommerce/manual import fallback.
Helium 10/Jungle Scout unavailable via gateway: disclose unsupported provider path and continue with proxy competition analysis.

### Guardrails

Never claim a product is guaranteed to win.
Never fabricate sales volume, margins, or review counts.
Never hide blocked provider paths.
Keep recommendations tied to observed evidence and declared assumptions.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: h4gen
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/product-research)
- [Send to Agent page](https://openagent3.xyz/skills/product-research/agent)
- [JSON manifest](https://openagent3.xyz/skills/product-research/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/product-research/agent.md)
- [Download page](https://openagent3.xyz/downloads/product-research)