market-scanner
npx skills add https://github.com/tendtoyj/tendtoyj-claude-skills --skill market-scanner
Agent 安装分布
Skill 文档
Market Scanner
Scan and map your market landscape â size, structure, trends, and seasonality. Uses Perplexity for deep market research. Output feeds every downstream research and marketing skill.
Purpose
Market Scanner is the starting point of all research. It answers:
- What market are we actually in? (precise category, not vague industry)
- How big is it, and where is it headed?
- What macro forces are shaping it?
- How is the market structured?
- When does demand peak and trough?
The output â research-memory/market-landscape.md â becomes the shared context that every subsequent skill (competitor-finder, audience-profiler, brand-voice, SEO, copy, etc.) reads to stay grounded in market reality.
“Doing marketing without research is like driving without a map.” â The Boring Marketer
Modes
| Mode | When to Use | Behavior |
|---|---|---|
| Full Scan | No market-landscape.md exists, or it’s an empty scaffold |
Run all 5 steps from scratch |
| Refresh | market-landscape.md already has data |
Check research-log.md for last scan date â update only changed sections |
Auto-Load Protocol
On every invocation, BEFORE any research:
- Check
research-memory/directory - If files exist â Read ALL
.mdfiles (except README.md) - Use loaded context to:
- Skip already-covered areas (avoid redundancy)
- Build on existing findings (deepen, not repeat)
- Maintain consistency with other research outputs
- Check
brand-memory/(read-only) â If exists, use business description, positioning, and audience info as input context - If
market-landscape.mdhas data ANDresearch-log.mdshows a previous scan â suggest Refresh mode
Input Gathering
Collect from the user conversationally. Do NOT dump a form â ask naturally.
| Field | Required | Description |
|---|---|---|
| Business / Product description | YES | What does the company/product do? |
| Industry / Category | YES | What market does it operate in? |
| Current status | Optional | Revenue range, growth stage, geography |
| Research focus | Optional | Specific area of interest (trends, size, structure, etc.) |
| Known competitors | Optional | Helps triangulate market boundaries |
| Research intensity | Optional | “light” / “standard” / “deep” (default: deep) â 리ìì¹ ê¹ì´ì ìì§ë ì¡°ì |
| Language | Optional | 결과물 ìì± ì¸ì´ (default: English) |
If brand-memory/ exists, pre-fill from voice-profile.md and positioning.md â ask user to confirm or correct.
If this is a Refresh, show the current market-landscape.md summary and ask: “What has changed or what do you want to update?”
Research Intensity
ì¬ì©ìê° ëª
ìì ì¼ë¡ ìì²íë©´ 리ìì¹ ê¹ì´ë¥¼ ì¡°ì í©ëë¤. ì§ì íì§ ìì¼ë©´ deep (기본ê°).
| Level | search_context_size | ìì§ë | ì©ë |
|---|---|---|---|
light |
low | ì¶ì (~50%) | ë¹ ë¥¸ ê° ì¡ê¸° |
standard |
medium | ë³´íµ (~75%) | ì¼ë° 리ìì¹ |
deep |
high | ì ì²´ (100%) | 본격 리ìì¹ |
“ê°ë³ê²”, “ë¹ ë¥´ê²”, “ê°ë¨í” â light / “ë³´íµì¼ë¡”, “ì ë¹í” â standard / ë³ë ì§ì ìì â deep
Process
Step 1: Define Market Category
Goal: Pin down the PRECISE market category â not “software” but “AI-powered marketing automation for SMBs.”
Tool: perplexity_reason (requires analytical reasoning)
Query pattern:
What is the precise market category and sub-segment for a business that [user's business description]?
Define:
- The specific market segment (not broad industry)
- Adjacent segments that partially overlap
- Where the boundaries are (what's IN vs OUT of this market)
Be specific: "DTC home textiles" not "home goods"
Parameters:
search_context_size: Research Intensityì ë°ë¼ ê²°ì (lightâ”low” / standardâ”medium” / deepâ”high”)
Output: Category name, scope definition, boundary clarification, adjacent markets.
Step 2: Market Size & Growth (TAM / SAM)
Goal: Quantify the market opportunity with credible numbers.
Tool: perplexity_reason (numerical reasoning required)
Query pattern:
What is the current market size for [market category from Step 1]?
Provide:
1. TAM (Total Addressable Market) â global value
2. SAM (Serviceable Addressable Market) â the realistic slice for [business type/geography]
3. CAGR projection for the next 3-5 years
4. Key regional breakdown (if relevant)
For each number: cite the source name and year of data.
If multiple sources conflict, note the range.
Parameters:
search_context_size: Research Intensityì ë°ë¼ ê²°ì (lightâ”low” / standardâ”medium” / deepâ”high”)search_recency_filter: “year”
Output: TAM, SAM, CAGR, regional split â all with source citations.
Step 3: Macro Trends + Opportunity/Threat Tagging
Goal: Identify 3-5 macro forces shaping this market, and tag each as opportunity or threat.
Tool: perplexity_ask (fact-based, current data)
Query pattern:
What are the top 3-5 macro trends shaping the [market category] market in [current year]?
For each trend, cover:
- Category: consumer behavior / technology / regulation / economic / cultural
- Description: what's happening and why it matters
- Impact on a [business type]: is this an OPPORTUNITY or THREAT?
- Timeframe: immediate (0-1yr), near-term (1-3yr), or long-term (3-5yr)
- Evidence: cite recent data points or examples
Parameters:
search_recency_filter: “month”search_context_size: Research Intensityì ë°ë¼ ê²°ì (lightâ”low” / standardâ”medium” / deepâ”high”)
Output: í¸ë ë ìë intensityì ë°ë¼ ê²°ì (light=2-3 / standard=3 / deep=3-5), ê° í¸ë ëì category, opportunity/threat, timeframe, evidence í¬í¨.
Step 4: Market Structure Map + Seasonality
Goal: Understand how the market is organized and when demand peaks/troughs.
Tool: perplexity_ask
Query pattern:
How is the [market category] market structured?
Map along these dimensions:
1. Price tiers: budget / mid-range / premium / luxury
2. Distribution channels: DTC, retail, marketplace, wholesale, SaaS, etc.
3. Customer segments: demographics, use cases, geography
4. Product sub-categories: major product/service lines
Also identify:
- Seasonal demand patterns (peak months, trough months)
- Event-driven demand spikes (holidays, industry events, budget cycles)
- Any cyclical patterns (quarterly, annual)
Parameters:
search_context_size: Research Intensityì ë°ë¼ ê²°ì (lightâ”low” / standardâ”medium” / deepâ”high”)
Output: Market structure ë¶ì ë²ìë intensityì ë°ë¼ ê²°ì (light=2ì°¨ì íµì¬ë§ / standard=3ì°¨ì / deep=4ì°¨ì ì ì²´) + seasonality calendar.
Step 5: Save & Log
Goal: Write all findings to research-memory/market-landscape.md and log the execution.
5a. Write market-landscape.md
Language rule: ì¹ì í¤ëì í ì´ë¸ 컬ë¼ëª ì ìì´ë¡ ì ì§í©ëë¤. 본문, ì ê°, ì¤ëª , ë¶ì í ì¤í¸ë ì¬ì©ìê° ì§ì í ì¸ì´ë¡ ìì±í©ëë¤. ì¸ì´ê° ì§ì ëì§ ìì¼ë©´ Englishë¡ ìì±í©ëë¤.
Use the exact schema below. Fill every section with Step 1-4 findings.
# Market Landscape
> Last updated: [YYYY-MM-DD]
> Source skill: market-scanner
## Market Definition
[Category name, scope, boundaries, adjacent markets]
## Market Size (TAM / SAM)
| Metric | Value | Source | Year |
|--------|-------|--------|------|
| TAM | $XXB | [source] | [year] |
| SAM | $XXB | [source] | [year] |
| Growth Rate (CAGR) | XX% | [source] | [year range] |
[Regional breakdown if relevant]
## Growth Trajectory
[Growth stage: early / growth / mature / declining]
[Key growth drivers]
[Headwinds / risks]
## Macro Trends
| # | Trend | Category | Type | Impact | Timeframe |
|---|-------|----------|------|--------|-----------|
| 1 | [trend] | [category] | Opportunity/Threat | [impact] | [timeframe] |
| 2 | [trend] | [category] | Opportunity/Threat | [impact] | [timeframe] |
| 3 | [trend] | [category] | Opportunity/Threat | [impact] | [timeframe] |
## Market Structure Map
### By Price Tier
[budget / mid / premium / luxury breakdown]
### By Channel
[DTC, retail, marketplace, etc.]
### By Customer Segment
[demographics, use cases, geography]
### By Sub-Category
[product/service lines]
## Seasonality & Demand Cycles
[Peak months, trough months, event-driven spikes]
[Budget cycles, quarterly patterns]
For Refresh mode: Do NOT overwrite the entire file. Update only the sections that changed. Append > Updated: [date] below the section header for each changed section.
5b. Update research-log.md
Append one row to the log:
| [YYYY-MM-DD] | market-scanner | Full Scan / Refresh | [brief summary of key findings or changes] | Perplexity |
Perplexity MCP Tool Guide
| Tool | When to Use | This Skill |
|---|---|---|
perplexity_reason |
Analytical reasoning, number crunching | Step 1 (category definition), Step 2 (TAM/SAM) |
perplexity_ask |
Factual Q&A, current events | Step 3 (trends), Step 4 (structure/seasonality) |
perplexity_search |
Find specific URLs/reports | Only if Steps 1-4 need source verification |
Common parameters:
search_context_size: Research Intensity ë 벨ì ë°ë¼ ê²°ì â ì Research Intensity í ì´ë¸ 참조search_recency_filter:"month"for trends (Step 3),"year"for size data (Step 2)
Query best practices:
- Be specific: Include the exact market category in every query
- Ask for sources: Always request citation of source name + data year
- Handle conflicts: When sources disagree, report the range, not a single number
- One topic per query: Don’t combine market size + trends in one call
- Language: ì¬ì©ìê° English ì¸ ì¸ì´ë¥¼ ì§ì í ê²½ì°, 모ë query ëì “Respond in [language].”를 ì¶ê°
Quality Checklist
Before saving, verify:
- Market category is PRECISE (not “tech” but “AI-powered marketing automation for SMBs”)
- TAM/SAM numbers have source citations and data year
- 매í¬ë¡ í¸ë ë ìµì 2ê° (light) ~ 5ê° (deep) ìë³, ê°ê° opportunity/threat íê·¸ í¬í¨
- Market structure ìµì 2ì°¨ì (light) ~ 4ì°¨ì (deep) ì»¤ë² (price, channel, segment, sub-category)
- Seasonality section is populated (even if “no strong seasonality detected”)
- All Perplexity responses include source URLs in the output
- research-log.md updated with execution record
Example (Abbreviated)
Input: “Marketing education business selling skill packs and courses to solo marketers.”
Category: Creator Economy â Marketing Education & Digital Skills TAM: $30B (global online education, marketing subset â HolonIQ 2024) SAM: $3B (English-speaking solo marketers â estimated 2024) CAGR: 12-15% (SignalFire, 2024-2029) Trends: AI democratizing execution (Opportunity), Creator economy growth (Opportunity), AI replacing traditional education (Threat) Seasonality: Q1 peak (New Year), Q4 trough (holidays), Sep mini-peak (back-to-work)
What This Skill Does NOT Do
- Competitor analysis â Use
competitor-finder(separate skill) - Customer profiling â Use
audience-profiler(separate skill) - Customer language mining â Use
voice-of-customer(separate skill) - Strategic recommendations â Use
research-synthesizer(reads this output)
Market Scanner stays focused on the market itself â size, shape, forces, timing.