How do I install the Market Research skill?

Run npx skillmds@latest add luokai0/market-research in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Market Research safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Market Research?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Market Research free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Market Research?

luokai0 (@luokai0) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Market Research by luokai0 — Agent Skill

Name: Market Research
Rating: 4.5 (4 reviews)
Author: luokai0

Market Research

Industry statistics and market sizing via free government APIs (BLS, FRED, Census Bureau). Query employment data, economic time series, establishment counts, and build market sizing reports by NAICS industry code. Use for any industry research or market analysis question.

luokai0 Updated Sep 8, 2026 10 repo stars

File contents

Setup

Install this skill to Skills/market-research/
Sign up for free API keys (all free, no usage limits worth worrying about):
- BLS: https://data.bls.gov/registrationEngine/ -> add as BLS_API_KEY in Settings > Advanced
- FRED: https://fred.stlouisfed.org/docs/api/api_key.html -> add as FRED_API_KEY
- Census: https://api.census.gov/data/key_signup.html -> add as CENSUS_API_KEY
Install the Python dependency: pip install httpx

CLI

python3 /home/workspace/Skills/market-research/scripts/research.py <command> [options]

Commands

Command	Source	Description
`industry <naics>`	BLS	Employment and wage data for a NAICS industry code
`establishments <naics>`	Census CBP	Establishment counts by industry and geography
`economic-census <naics>`	Census	Revenue, payroll, establishments from the Economic Census
`fred-search <query>`	FRED	Find relevant FRED series by keyword
`fred-data <series_id>`	FRED	Get time series data for a FRED series
`sizing <naics>`	All	Combined market sizing report

Options

Flag	Description
`--state <fips>`	State FIPS code filter (e.g. 04 = Arizona, 06 = California)
`--years <n>`	Number of years of data (default: 5)
`--output <file>`	Save to file

NAICS Codes

NAICS (North American Industry Classification System) is how the US government categorizes industries. Examples:

423990: Other Miscellaneous Durable Goods Merchant Wholesalers
336214: Travel Trailer and Camper Manufacturing
541511: Custom Computer Programming Services
722511: Full-Service Restaurants
44-45: Retail Trade (sector level)

Find codes: https://www.census.gov/naics/

Examples

# Employment + wages for custom software development
python3 scripts/research.py industry 541511

# Establishment counts in California
python3 scripts/research.py establishments 541511 --state 06

# Search FRED for relevant series
python3 scripts/research.py fred-search "software industry output"

# Get GDP data
python3 scripts/research.py fred-data GDP --years 10

# Full market sizing report
python3 scripts/research.py sizing 541511

Data Sources

BLS QCEW: Quarterly employment and wages, updated quarterly. Most complete employment data by NAICS.
FRED: 800,000+ economic time series. GDP, CPI, PPI, industry output, financial data. Real-time updates.
Census Bureau: County Business Patterns (annual establishment counts), Economic Census (every 5 years, most recent 2022).

Notes

All government APIs are free. No usage limits worth worrying about.
BLS data is quarterly with about a 6-month lag.
Census CBP data is annual with about a 1-year lag.
Economic Census data is every 5 years (2017, 2022). Latest 2022 data is available.
The sizing command combines all three sources into a single markdown report.
State FIPS codes: https://www.census.gov/library/reference/code-lists/ansi.html

---name: market-researchdescription: Industry statistics and market sizing via free government APIs (BLS, FRED, Census Bureau). Query employment data, economic time series, establishment counts, and build market sizing reports by NAICS industry code. Use for any industry research or market analysis question.---## Setup1. Install this skill to `Skills/market-research/`2. Sign up for free API keys (all free, no usage limits worth worrying about): - **BLS**: https://data.bls.gov/registrationEngine/ -> add as `BLS_API_KEY` in [Settings > Advanced](/?t=settings&s=advanced) - **FRED**: https://fred.stlouisfed.org/docs/api/api_key.html -> add as `FRED_API_KEY` - **Census**: https://api.census.gov/data/key_signup.html -> add as `CENSUS_API_KEY`3. Install the Python dependency: `pip install httpx`## CLI```bashpython3 /home/workspace/Skills/market-research/scripts/research.py <command> [options]```## Commands| Command | Source | Description ||---------|--------|-------------|| `industry <naics>` | BLS | Employment and wage data for a NAICS industry code || `establishments <naics>` | Census CBP | Establishment counts by industry and geography || `economic-census <naics>` | Census | Revenue, payroll, establishments from the Economic Census || `fred-search <query>` | FRED | Find relevant FRED series by keyword || `fred-data <series_id>` | FRED | Get time series data for a FRED series || `sizing <naics>` | All | Combined market sizing report |## Options| Flag | Description ||------|-------------|| `--state <fips>` | State FIPS code filter (e.g. 04 = Arizona, 06 = California) || `--years <n>` | Number of years of data (default: 5) || `--output <file>` | Save to file |## NAICS CodesNAICS (North American Industry Classification System) is how the US government categorizes industries. Examples:- 423990: Other Miscellaneous Durable Goods Merchant Wholesalers- 336214: Travel Trailer and Camper Manufacturing- 541511: Custom Computer Programming Services- 722511: Full-Service Restaurants- 44-45: Retail Trade (sector level)Find codes: https://www.census.gov/naics/## Examples```bash# Employment + wages for custom software developmentpython3 scripts/research.py industry 541511# Establishment counts in Californiapython3 scripts/research.py establishments 541511 --state 06# Search FRED for relevant seriespython3 scripts/research.py fred-search "software industry output"# Get GDP datapython3 scripts/research.py fred-data GDP --years 10# Full market sizing reportpython3 scripts/research.py sizing 541511```## Data Sources- **BLS QCEW**: Quarterly employment and wages, updated quarterly. Most complete employment data by NAICS.- **FRED**: 800,000+ economic time series. GDP, CPI, PPI, industry output, financial data. Real-time updates.- **Census Bureau**: County Business Patterns (annual establishment counts), Economic Census (every 5 years, most recent 2022).## Notes- All government APIs are free. No usage limits worth worrying about.- BLS data is quarterly with about a 6-month lag.- Census CBP data is annual with about a 1-year lag.- Economic Census data is every 5 years (2017, 2022). Latest 2022 data is available.- The `sizing` command combines all three sources into a single markdown report.- State FIPS codes: https://www.census.gov/library/reference/code-lists/ansi.html

Frequently asked questions