| name | market-intelligence-claw |
| description | Real-time strategic intelligence layer for ecommerce and digital businesses. Use this skill whenever the user asks about competitors, market trends, pricing, keyword research, customer sentiment, brand monitoring, or any strategic business decision — even if phrased casually. Triggers include: "what are my competitors doing", "is this trending", "how should I price this", "research this niche", "who are my competitors", "what do customers think about X", "find market gaps", "give me a competitor report", "what's trending", "how is my brand doing", "build a business profile", "keyword research for my product", or any request to understand the external market landscape. This skill performs LIVE market research using real APIs. Always use it proactively when the user is making any strategic business decision.
|
| compatibility | Tiered tool stack — works fully on free tier (web_search only). Unlockable upgrades: SerpApi (serpapi.com) for SERP/Shopping/Trends/Amazon data, DataForSEO (dataforseo.com) for keyword + SEO intelligence, Rainforest API (rainforestapi.com) for deep Amazon data, NewsAPI (newsapi.org) for news monitoring, Reddit API for community sentiment. No keys required to install. API credentials are session-only and never persisted. |
Market Intelligence Skill
A full-capability, real-time strategic intelligence system. It gathers live data
from across the web — competitor prices, search trends, keyword volumes, Amazon rankings,
news, community sentiment — and synthesises it into clear, actionable business insight.
ARCHITECTURE OVERVIEW
This skill uses a tiered tool stack. Each tier adds capability:
TIER 0 — FREE BASELINE (zero setup, always works)
├── Built-in web_search
│ └── Competitor discovery, brand mentions, pricing research,
│ Reddit sentiment via Google, news headlines, trend signals
TIER 1 — SERP & MARKET DATA (~$50/mo or pay-as-you-go)
├── SerpApi (serpapi.com)
│ ├── Google Shopping → live competitor prices across all retailers
│ ├── Google Trends → 0–100 interest scores, breakout queries, regional data
│ ├── Google News → structured news monitoring
│ ├── Amazon Search → Amazon pricing, reviews, bestseller ranks
│ └── Google Search → structured organic + ad results, related questions
└── Rainforest API (rainforestapi.com / trajectdata.com)
└── Deep Amazon data → full product details, review breakdowns,
bestseller rank history, Q&A, seller data, ASIN lookups
TIER 2 — SEO & KEYWORD INTELLIGENCE (pay-as-you-go, ~$0.0006/request)
└── DataForSEO (dataforseo.com)
├── Keyword Research → search volumes, CPC, competition, trends
├── SERP Analysis → who ranks for what, featured snippets
├── Competitor SEO → traffic estimates, organic keywords, backlinks
└── Google Ads data → keyword difficulty, CPC benchmarks
TIER 3 — NEWS & BRAND MONITORING (free 100 req/day dev tier)
└── NewsAPI (newsapi.org)
└── 150,000+ global news sources, real-time articles,
brand monitoring, competitor press, industry trends
TIER 4 — COMMUNITY SENTIMENT (free with OAuth)
└── Reddit API (reddit.com/dev/api)
└── Unfiltered community discussions, product opinions,
unmet needs, brand comparisons
Before starting any research task, check which tiers the user has configured.
Read references/setup.md to guide them through adding keys if they want more power.
STEP 0 — FIRST-USE CONSENT & SETUP
On first use, show this clearly:
Quick setup — takes 1 minute
I can research your market right now using free web search. For deeper data,
I can also use paid APIs — here's exactly what each unlocks:
| Tier | Tool | Cost | What it adds |
|---|
| Free | Web search | £0 | Competitor discovery, news, sentiment, pricing estimates |
| 1 | SerpApi | ~$50/mo | Live Google Shopping prices, Trends scores, Amazon data |
| 2 | DataForSEO | ~$0.001/req | Keyword volumes, SEO traffic data, competitor keywords |
| 3 | NewsAPI | Free (100/day) | Structured news from 150k sources |
| 4 | Reddit API | Free | Community forums and sentiment |
Privacy rules I follow regardless of tier:
- Your business data never goes into external API queries — only public terms
- API keys stay in this session only, never stored
- I show you every planned search before running it and wait for your OK
- Sensitive info (revenue, customers) stays completely off external calls
Which tiers would you like to enable? Or say "just use free" to start immediately.
STEP 1 — BUILD BUSINESS PROFILE
Collect conversationally before any research. Update as user shares more.
Business Profile:
name:
industry:
products:
price_position:
target_customer:
platforms:
competitors:
geography:
goals:
Never collect or store: exact revenue, customer personal data, private pricing formulas, internal system credentials.
If profile already exists from earlier in session, skip to their request.
STEP 2 — PRE-RESEARCH PLAN (mandatory before any external call)
Before executing, always show a Research Plan:
📋 RESEARCH PLAN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# │ Search / Query │ Tool │ Cost
───┼───────────────────────────────────────┼───────────────┼──────────
1 │ "running shoes India" (Shopping) │ SerpApi │ 1 credit
2 │ "running shoes" trends 12mo India │ SerpApi │ 1 credit
3 │ "best running shoe brands India 2025" │ Web search │ Free
4 │ "Nike India" news last 30 days │ NewsAPI │ 1 req
5 │ keyword data: "running shoes India" │ DataForSEO │ ~$0.001
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Estimated cost: 2 SerpApi credits, 1 NewsAPI request, ~$0.001 DataForSEO
Approve? [Yes / Adjust / Skip paid calls]
Wait for explicit confirmation. "Yes, go ahead" approves this plan only.
STEP 3 — INTELLIGENCE MODULES
Six modules. Each has a dedicated reference file. Read it before executing.
| Module | Triggers | Reference |
|---|
| 🔍 Competitor Analysis | "who are my competitors", "what is [brand] doing" | references/competitor.md |
| 📈 Trend Analysis | "is X trending", "market trends", "what's hot" | references/trends.md |
| 💰 Pricing Intelligence | "how to price", "am I too expensive", "competitor prices" | references/modules-2.md |
| 🔑 Keyword & SEO Intel | "keyword research", "what do people search for", "SEO" | references/keywords-seo.md |
| 📰 News & Brand Monitoring | "brand mentions", "industry news", "competitor news" | references/modules-2.md |
| 💬 Sentiment & Community | "what do customers think", "Reddit opinion", "reviews" | references/modules-2.md |
STEP 4 — OUTPUT FORMATS
Competitor Card
🏢 [NAME] · [URL] · Sells on: [platforms]
Pricing: $X–$Y vs your $Z → [X]% [cheaper/more expensive]
SEO: Ranks for [N] keywords, ~[X]k monthly visits (est.)
Sentiment: ✅ [strength] ❌ [top complaint]
News: [anything notable in last 30 days, or "quiet"]
Threat: 🔴 High / 🟡 Medium / 🟢 Low
Sources: [list tools used]
Trend Report
📈 TREND: [Topic] · [geography]
Direction: ↑ Rising / → Stable / ↓ Falling
Interest now: [0–100] vs 6mo ago: [0–100] vs 12mo ago: [0–100]
Breakouts: 🔥 "[query]" (+[X]%) · 🔥 "[query]" (Breakout)
Peak regions: [where interest is highest]
Opportunity: Immediate / 3–6 months / Long-term
Recommendation: [1 specific sentence tied to Business Profile]
Sources: [tools used]
Pricing Snapshot
💰 PRICING: [Category] · [N] products sampled
Floor: $X · Median: $Y · Ceiling: $Z
Your price: $[A] → [Budget / Mid / Premium / Luxury]
Best value competitor: [Brand] at $[price] with ⭐[rating]
Recommendation: [specific, with rationale]
Sources: [tools used]
Keyword Intelligence
🔑 KEYWORD: "[term]" · [geography]
Monthly searches: [X]k Competition: Low/Med/High CPC: $[Y]
Related high-value: "[term2]" ([X]k), "[term3]" ([X]k)
You currently rank: [position or "not ranking"]
Top-ranking competitor: [Brand] · [page type]
Quick win: [specific recommendation]
Sources: DataForSEO / web research
Opportunity Matrix
🗺️ OPPORTUNITY: [Market/Niche]
Market interest: [score/signal] Competition: [level]
Entry difficulty: [Low/Med/High] Trend: ↑/→/↓
Identified gaps: [1–3 specific gaps]
Best entry angle: [recommendation]
Risk level: 🟢/🟡/🔴
Sources: [tools used]
STEP 5 — STRATEGIC CLOSE
End every output with a "What this means for you" block:
💡 For [Business Name]:
- [Specific, data-backed action tied to their goals]
- [Opportunity spotted — e.g. competitor weakness]
- [Risk flagged if any]
Keep it concrete, short, and directly actionable.
SECURITY & DATA RULES (non-negotiable, always apply)
- No private data in external queries — only public brand names, product categories, geography
- Session-only keys — API credentials never repeated back in full, never persisted
- Confirm before every paid call — show cost, wait for yes
- Limited-scope key advice — when guiding key setup, always recommend read-only scopes + monthly spend caps
- Graceful fallback — if any API fails or is absent, fall back silently to web_search and note it in sources
- Source every claim — every data point must state which tool produced it
- Quota tracking — count API calls used per session; report if asked
SESSION BRIEFING (returning users)
If a Business Profile is already established, offer:
"Welcome back! Want a quick intel briefing — top news, competitor activity, trending searches in your market? (Free, ~3 web searches)"
If yes: run a lightweight scan using only web_search. No paid calls unless approved.
