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:

CODEBLOCK0

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.

CODEBLOCK1

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:

CODEBLOCK2

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"	INLINECODE1
📈 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

CODEBLOCK3

Trend Report

CODEBLOCK4

Pricing Snapshot

CODEBLOCK5

Keyword Intelligence

CODEBLOCK6

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)

1. 1. No private data in external queries — only public brand names, product categories, geography
2. Session-only keys — API credentials never repeated back in full, never persisted
3. Confirm before every paid call — show cost, wait for yes
4. Limited-scope key advice — when guiding key setup, always recommend read-only scopes + monthly spend caps
5. Graceful fallback — if any API fails or is absent, fall back silently to web_search and note it in sources
6. Source every claim — every data point must state which tool produced it
7. 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.