# Oneshot Enrichment

> |

- **Type:** Skill
- **Install:** `agentstack add skill-oneshot-agent-agent-skills-oneshot-enrichment`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [oneshot-agent](https://agentstack.voostack.com/s/oneshot-agent)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [oneshot-agent](https://github.com/oneshot-agent)
- **Source:** https://github.com/oneshot-agent/agent-skills/tree/main/skills/oneshot-enrichment

## Install

```sh
agentstack add skill-oneshot-agent-agent-skills-oneshot-enrichment
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# OneShot — People & Person Intelligence

Set up auth/wallet via the **`oneshot`** skill, then:

```typescript
import { OneShot } from '@oneshot-agent/sdk';
const agent = await OneShot.create({ cdp: true });
```

## People search — `agent.peopleSearch(options)`

```typescript
const found = await agent.peopleSearch({
  job_titles: ['CTO', 'VP Engineering'],
  companies: ['Acme Corp'],
  company_domains: ['acme.com'],
  location: ['San Francisco', 'Remote US'],
  skills: ['Rust', 'distributed systems'],
  seniority: ['executive'],
  industry: ['software'],
  keywords: ['payments'],
  company_size: '51-200',
  limit: 25,
});
// found.{ results: PersonResult[], total_found }
```

All filters optional; combine to narrow. `PersonResult` includes name, title, company,
`linkedin_url`, `email`, `phone`, `skills`, `experience`, `education`, normalized
`best_work_email`/`best_personal_email`.

## Enrich a profile — `agent.enrichProfile(options)`

```typescript
const { profile } = await agent.enrichProfile({
  linkedin_url: 'https://linkedin.com/in/janedoe', // or email / name + company_domain
});
```

Options: `linkedin_url`, `email`, `name`, `company_domain` (provide what you have).

## Find email — `agent.findEmail(options)`

```typescript
const res = await agent.findEmail({
  full_name: 'Jane Doe',        // or first_name + last_name
  company_domain: 'acme.com',   // REQUIRED
});
// res.{ email, found, full_name?, company_domain? }
```

## Verify email — `agent.verifyEmail(options)`

```typescript
const v = await agent.verifyEmail({ email: 'jane@acme.com' });
// v.{ valid, deliverable, catch_all, disposable }
```

Pair with the `oneshot-email` skill: verify before sending to protect deliverability.

## Deep person intelligence

All take at least one identifier (email, `social_media_url`, or name/company) and return rich
structured results. Each is a paid async tool.

```typescript
// Full dossier: career, interests, connections (~2–5 min)
await agent.deepResearchPerson({ email: 'jane@acme.com', name: 'Jane Doe', company: 'Acme' });

// Discover all social accounts (LinkedIn, X, GitHub, YouTube, …)
await agent.socialProfiles({ email: 'jane@acme.com' }); // or { social_media_url }

// Articles / publications about a person
await agent.articleSearch({ name: 'Jane Doe', company: 'Acme', sort: 'recent', limit: 10 });

// Recent social posts with engagement metrics
await agent.personNewsfeed({ social_media_url: 'https://x.com/janedoe' });

// Interest analysis across categories
await agent.personInterests({ social_media_url: 'https://x.com/janedoe' }); // or { email } / { phone }

// Map followers / following / replies
await agent.personInteractions({ social_media_url: 'https://x.com/janedoe', type: 'followers,following', max_results: 100 });
```

> Phone numbers sometimes arrive via an async webhook *after* enrichment completes. By default
> these tools return as soon as the profile is ready (`phones_pending: true`). To keep polling
> until phones land, pass `waitForPhones: true` (and optionally `phoneTimeoutSec`, default 360s).

## Pricing

These are paid per-call (people search scales with the number of results). See current per-tool
pricing at https://docs.oneshotagent.com/pricing. Set `maxCost` on `peopleSearch` (scales with
`limit`) and the deep-intel tools.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [oneshot-agent](https://github.com/oneshot-agent)
- **Source:** [oneshot-agent/agent-skills](https://github.com/oneshot-agent/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-oneshot-agent-agent-skills-oneshot-enrichment
- Seller: https://agentstack.voostack.com/s/oneshot-agent
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.