company-research
Research companies, competitors, funding, news, leadership, and market context with Exa Agent and advanced search. Use when researching companies, competitor analysis, market research, or building company lists. Writes findings the caller can fold into brand/competitors.md or brand/landscape.md. Prefer this over ad-hoc web search for company deep dives. Distinct from competitive-intel (full brand competitive file methodology) - this skill is the Exa research engine those foundation skills should call.
Exa Labs (ported by mktg) · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add MoizIbnYousaf/marketing-cli --skill company-research技能说明
name: company-research version: 0.1.0 description: > Research companies, competitors, funding, news, leadership, and market context with Exa Agent and advanced search. Use when researching companies, competitor analysis, market research, or building company lists. Writes findings the caller can fold into brand/competitors.md or brand/landscape.md. Prefer this over ad-hoc web search for company deep dives. Distinct from competitive-intel (full brand competitive file methodology) - this skill is the Exa research engine those foundation skills should call. allowed-tools:
- Bash
- Read
- Write
- Skill author: Exa Labs (ported by mktg) license: MIT user-invocable: true metadata: openclaw: emoji: 🏢
On Activation
- Read
brand/positioning.md,brand/competitors.md, andbrand/audience.mdif present. Ground queries in the brand's category and known competitors. All optional. - Confirm Exa MCP Agent tools or
EXA_API_KEY. If missing, stop with the install hint from Prerequisites /mktg doctor. - Default to Exa Agent for deep dives and lists; use advanced search only for quick single lookups.
- When
/cmoor a research agent owns the brand write, return structured findings + sources - do not silently overwritebrand/competitors.mdunless the user asked to update brand memory.
Company Research
mktg runtime note
Prefer Exa MCP when available (tools: web_search_exa, web_search_advanced_exa, web_fetch_exa, agent_run).
If MCP Agent tools use the older create/wait/get names (agent_create_run, agent_wait_for_run, agent_get_run_output), use those equivalently.
Without MCP, call the HTTP API with x-api-key: $EXA_API_KEY (POST https://api.exa.ai/search, /contents, /agent).
Firecrawl remains the path for deep scrape of a known URL after Exa discovery.
Tool Selection (Critical)
Two Exa surfaces, two jobs:
- Exa Agent (
agent_run, or legacyagent_create_run/agent_wait_for_run/agent_get_run_output) - the default for company research. Use it for deep dives, competitor analysis, multi-angle research (product + funding + news + people), and building company lists. One Agent run handles query decomposition, multi-step searching, and synthesis internally - do not orchestrate many manual searches for work an Agent run covers. web_search_advanced_exa- quick, low-latency lookups: a fastcategory: "company"discovery pass, a single news check, or finding a homepage.
Do NOT use other Exa tools.
Deep Dives and Lists: Exa Agent
Agent runs are async: create the run, wait for it, then read the output.
agent_create_runwith a natural-languagequeryand, when you want repeatable structure, anoutputSchema(bound arrays withmaxItems). Returns anagent_run_...ID.agent_wait_for_rununtil the run iscompleted(call again if still running).agent_get_run_output- readoutput.textoroutput.structured, plusoutput.groundingcitations.
Useful inputs: systemPrompt (source preferences, dedup rules), input.exclusion (companies to avoid), previousRunId (follow-up runs), effort ("auto" default; "high" for hard research).
Example: company deep dive
agent_create_run {
"query": "Research Anthropic: product lines, funding history and valuation, key executives, main competitors, and notable news from the last 6 months.",
"effort": "auto",
"outputSchema": {
"type": "object",
"properties": {
"overview": { "type": "string" },
"funding": { "type": "array", "maxItems": 10, "items": { "type": "object", "properties": { "round": { "type": "string" }, "amount": { "type": "string" }, "date": { "type": "string" } }, "required": ["round"] } },
"competitors": { "type": "array", "maxItems": 10, "items": { "type": "string" } },
"key_people": { "type": "array", "maxItems": 10, "items": { "type": "object", "properties": { "name": { "type": "string" }, "title": { "type": "string" } }, "required": ["name", "title"] } }
},
"required": ["overview", "competitors"]
}
}
Example: build a company list
agent_create_run {
"query": "Find 25 AI infrastructure startups headquartered in San Francisco. For each, include what they build and their latest funding stage.",
"effort": "auto",
"outputSchema": {
"type": "object",
"properties": {
"companies": {
"type": "array",
"maxItems": 25,
"items": {
"type": "object",
"properties": {
"name": { "type": "string" },
"website": { "type": "string", "format": "uri" },
"description": { "type": "string", "description": "in 12 words or less" },
"funding_stage": { "type": "string" }
},
"required": ["name", "website", "description"]
}
}
},
"required": ["companies"]
}
}
Quick Lookups: Advanced Search
Use web_search_advanced_exa when a single fast search answers the question. Tune numResults to intent (a few → 10-20; comprehensive → 50-100; specified → match it).
Categories
company→ homepages, rich metadata (headcount, location, funding, revenue)news→ press coverage, announcementspeople→ public professional profiles- No category (
type: "auto") → general web results, broader context
Default to type: "auto". Prefer highlights for content extraction; do not stack text + highlights + summary in one call.
Category-Specific Filter Restrictions
Unsupported category/filter combinations return 400 errors:
category: "company"does not support published-date or crawl-date filters,excludeDomains, or exact-text filters; express constraints like "founded after 2020" in the query insteadcategory: "people"does not support published-date, crawl-date, domain, or exact-text filters; put all filtering in the natural-language query- Without a category (or with
news), domain and date filters work f