# Company Account Research Brief — Ravn

Canonical: https://askravn.com/skills/account-research-brief

Claude skill

# Account research brief

Build a one-page brief on a company from its domain: what it says it does, how big it is, where it is, what its website runs on, public contact points and the leaders worth knowing. It combines the company's own website with a company profile and a short people search that run on your own data-provider account.
[Download SKILL.md](https://askravn.com/skills/account-research-brief/SKILL.md) [Start free](https://askravn.com/#start)

Install
## One command.
Installs into `~/.claude/skills` for Claude Code. In Claude, upload the downloaded file under Settings → Capabilities → Skills.
```
npx ravn skill install account-research-brief
```

## When to use

- "Give me a rundown on acme.com before I pitch them."
- An account executive is planning an account and needs the basics in one place.
- For a brief on one person ahead of a call, use meeting-prep instead.

## Before you start

- Check the connection: call `get_account` with `{}` or run `npx ravn whoami`.
- `domain_to_company` and `search_people` need your own provider key connected — run `ravn keys add pdl` first; these tools run on your own provider account. `scrape_website` is ours and needs no key. Every call is one lookup; misses are free. If a tool returns 403 `provider_key_required`, stop and tell the human to add their key.
- Confirm the domain. If the user gave a company name only, ask for the website.

## Steps

- Read the company's own site.

```
{ "domain": "acme.com" }
```

From `scrape_website`, take `name`, `title`, `description`, `address`, `emails`, `phones`, `socials` and `technologies`. The tool respects robots.txt; if it returns `not_found`, note that the site could not be read and carry on. 2. Get the firmographics.

```
{ "domain": "acme.com" }
```

From `domain_to_company`, take `name`, `size`, `employee_count`, `industry`, `founded`, `city`, `state`, `country`, `linkedin_url` and `naics_codes`. 3. Find the leadership. Ask the user which function they sell to; default to the executive team.

```
{ "company_domain": "acme.com", "seniority": ["C Suite", "VP", "Head"], "limit": 5 }
```

- Compare sources. If the website and the company profile disagree (for example on location), show both and say which source said what. Do not blend them into one invented fact.
- Group `technologies` into a few plain buckets (analytics, marketing, e-commerce, hosting, support) so the reader can scan them.
- Write the brief. Only state what the tools returned. Where a field is empty, leave it out rather than guessing.

## Output

A one-page Markdown brief with these sections:

- Snapshot: name, domain, one-line description from the site, industry, founded, size and employee count, HQ location.
- What they say about themselves: the site `title` and `description`, quoted.
- Tech on the website: grouped `technologies`.
- Public contact points: emails and phones listed on the site, plus `socials`.
- People to know: name, title, seniority, LinkedIn URL for up to five leaders.
- Sources and gaps: which tool supplied each section, what was not found, and lookups used.
If the user wants the people as a list, also save a CSV with `full_name`, `title`, `seniority`, `linkedin_url`, `business_email` and `business_email_risk_score`.

## Rules

- Public emails on a website are for that company's stated purpose. Do not add them to a cold list without the user deciding to, and verify them first.
- Do not include anyone who has asked not to be contacted. Opt-outs: [/privacy#optout](https://askravn.com/privacy#optout).
- No FCRA uses: do not research a company or its staff to make credit, employment, insurance or housing decisions about people.
- On a 429 `fair_use_exhausted` or a 403 `provider_key_required`, stop, deliver what you have and tell the human.

## Example prompt

I've got a first call with northwindtraders.com on Thursday. Put together a one-page brief: what they do, how big they are, what's on their site, and who runs the place.

## More [skills](https://askravn.com/skills)
Install them all with `npx ravn skill install --all`.
- [Build a Prospect List from Your ICPUse when someone describes their ideal customer and wants a prospect list built from scratch, with people found by title and company and emails verified..](https://askravn.com/skills/build-prospect-list)
- [Check Numbers Are Mobile Before TextingUse before sending SMS when someone needs to confirm each phone number is valid and a real mobile line, using number-plan checks then a live carrier lookup..](https://askravn.com/skills/check-mobile-before-sms)
- [Competitor Website Tech Stack LookupUse when someone wants to see which technologies competitor or prospect websites use, grouped by category and compared side by side..](https://askravn.com/skills/competitor-tech-stack)
- [Dedupe and Normalize a Contact ListUse when a contact CSV is messy and needs normalized emails, duplicates merged, and role, free-provider and disposable addresses flagged..](https://askravn.com/skills/dedupe-and-normalize-contacts)
- [Email Address to LinkedIn Profile LookupUse when someone has a list of email addresses and wants the person behind each one, with LinkedIn profile URL, name, title and company..](https://askravn.com/skills/email-to-linkedin-profile)
- [Enrich Any CSV with Contact and Company DataUse when someone hands over any CSV and wants it enriched, picking the right tool and column mapping, sampling, then running the full file safely..](https://askravn.com/skills/enrich-csv)