Market Research

---
name: market-research
description: >
  Research market size, trends, competitors, and decision-makers for any industry via the gooseworks data API (natural-language company search, financials, people search). Use when the user says "/omg-market-research", "/market-research", "market analysis", "market size", "TAM", "competitor research", or "industry research". R-MARKETING (research): the most-upstream skill — run before product-marketing-context and launch-strategy. Requires gooseworks credentials.
triggers: ["omg-market-research","market-research","market analysis","market size","TAM","competitor research","industry research","decision makers"]
allowed-tools: ["Bash","Read","Glob","Grep","WebFetch"]
domain: marketing
read_only: false
argument-hint: "<industry or market>"
source: gooseworks-ai/goose-skills (github.com/gooseworks-ai/goose-skills)
license: see upstream repo
---

> **OmegaOS skill** — vendored from gooseworks-ai/goose-skills (github.com/gooseworks-ai/goose-skills). Triggers `/omg-market-research` (and `/market-research`). Governed by R-MARKETING. **Requires:** the gooseworks data API + ~/.gooseworks/credentials.json (provision via `npx gooseworks login`); paid per-record.


# Market Research - Comprehensive Market Analysis

## Setup

Read your credentials from ~/.gooseworks/credentials.json:
```bash
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")
```

If ~/.gooseworks/credentials.json does not exist, tell the user to run: `npx gooseworks login`

All endpoints use Bearer auth: `-H "Authorization: Bearer $GOOSEWORKS_API_KEY"`


Research market size, trends, competitors, and growth opportunities for any industry.

## Workflow

### Step 1: Identify Key Players
Find companies in the market:

```bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"fiber","path":"/v1/natural-language-search/companies"}'
  "query": "AI software companies with over 100 employees, Series B or later funding"
}'
```

### Step 2: Research Company Details
Get detailed info on key players:

```bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"fiber","path":"/v1/company-search"}'
  "searchParams": {
    "company_names": ["OpenAI", "Anthropic", "Cohere"],
    "include_financials": true
  }
}'
```

### Step 3: Find Decision Makers
Identify leadership at key companies.

**Use Apollo first ($0.01 flat per call — cheapest option):**

```bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/apollo/mixed_people/search \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "person_titles": ["CEO", "CTO", "VP Product", "Head of Sales"],
  "organization_domains": ["openai.com", "anthropic.com"],
  "per_page": 25
}'
```

**Fallback — Fiber people search ($0.02/record):**

```bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/fiber/v1/people-search \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "searchParams": {
    "company_names": ["OpenAI", "Anthropic"],
    "job_titles": ["CEO", "CTO", "VP Product", "Head of Sales"]
  }
}'
```

## Example Usage

```bash
# Find companies by industry and size
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"fiber","path":"/v1/natural-language-search/companies"}'
  "query": "EdTech companies with 50-500 employees founded after 2018"
}'

# Search by specific criteria
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"fiber","path":"/v1/company-search"}'
  "searchParams": {
    "industries": ["Enterprise Software"],
    "employee_count_min": 100,
    "funding_stage": ["Series A", "Series B"]
  }
}'
```

## Tips

- Cite specific sources and dates for statistics
- Compare multiple analyst reports
- Look for both bullish and bearish perspectives
- Update research quarterly for fast-moving markets

## Discover More

List all endpoints, or add a path for parameter details:

```bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/search \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"fiber API endpoints"}'

Example: `curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/details \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"olostep","path":"/v1/scrapes`"}' for endpoint parameters.