Purpose

Identify product opportunities by combining:

1. social momentum,
2. regional demand checks,
3. marketplace competition/sales signals,
4. 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.

Tool Responsibilities

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