> ## Documentation Index
> Fetch the complete documentation index at: https://docs.extruct.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Extruct API Skill

> Build against the Extruct API from Claude Code, Codex, and other agent tooling with the official extruct-api skill.

Official repository:
[GitHub](https://github.com/extruct-ai/skills)

## Overview

The `extruct-api` skill gives coding agents the Extruct API's workflows, request shapes, and operating rules.
That makes it useful both for running Extruct tasks and for building against the Extruct API without re-explaining the product and endpoint mechanics in every prompt.

It covers company lookup and discovery with Company Lookup, Semantic Search, Lookalike Search, and Deep Search, plus AI Tables, enrichment, scoring, and people/contact workflows.

## Extruct MCP vs this skill

**[Extruct MCP](/build-with-ai-agents/extruct-mcp)** is the default, lowest-friction way to use Extruct from editors and agents that support remote MCP (OAuth through the client). The model sees **named tools**, not the raw REST API.

Use this **skill** when you want the opposite tradeoff: the repo ships **deep, embedded documentation** for workflows and payloads, so the agent often handles **long or finicky multi-step** tasks that map closely to the API. It assumes an **`EXTRUCT_API_TOKEN`** and is aimed at **more technical** users and codebases that call the HTTP API directly.

|          | Extruct MCP             | This skill                                  |
| -------- | ----------------------- | ------------------------------------------- |
| Auth     | OAuth in the client     | `EXTRUCT_API_TOKEN`                         |
| Surface  | MCP tools               | REST-shaped workflows in prompts            |
| Best for | Most users; quick setup | Power users; integration and API-heavy work |

## Prerequisites

```bash theme={null}
export EXTRUCT_API_TOKEN="YOUR_API_TOKEN"
```

Generate tokens in [Dashboard API Tokens](https://app.extruct.ai/api-tokens). For the underlying API setup, see [Authentication](/api-reference/authentication).

## Install

### Claude Code

```bash theme={null}
/plugin marketplace add extruct-ai/skills
/plugin install extruct-skills
```

### Codex

```bash theme={null}
$skill-installer https://github.com/extruct-ai/skills
```

`skill-installer` is a built-in Codex skill for installing skills from GitHub repositories.
Restart Codex after installation so it picks up the new skill.

### skills.sh

If you use the [Skills CLI](https://skills.sh/docs/cli), install the Extruct skill from GitHub:

```bash theme={null}
npx skills add extruct-ai/skills
```

## How it works

Once installed, the skill gives the agent a structured path for common Extruct workflows instead of relying on ad hoc prompts.
It helps the agent choose the right Extruct path, construct valid requests, inspect existing tasks and tables before mutating them, and carry async work through to completion.

The skill uses the same `EXTRUCT_API_TOKEN` as the API examples in this docs site and treats the public Extruct API contract as the source of truth.

## Typical prompts

Use prompts like:

* `Help me integrate the Extruct API into this codebase.`
* `Research the competitive landscape around vercel.com using Extruct.`
* `Give me an overview of my Extruct AI workspace.`
* `Search Extruct for AI procurement startups.`
* `Find companies similar to Ramp in Extruct.`
* `Create an Extruct table for target accounts and enrich it.`
* `Find decision makers at these companies in Extruct.`

## What the skill can do

* Run Company Lookup, Semantic Search, Lookalike Search, and Deep Search
* Help agents build against the Extruct API with the right workflow and payload shape
* Create, inspect, update, run, and read Extruct tables
* Add enrichment, scoring, and contact-finding workflows to existing tables
* Poll long-running tasks and return results in a consistent shape

## Resources

* [Extruct MCP](/build-with-ai-agents/extruct-mcp): remote MCP server (OAuth) for supported clients
* [Extruct AI skills repository](https://github.com/extruct-ai/skills)
* [skills.sh](https://skills.sh/)
* [Skills CLI docs](https://skills.sh/docs/cli)
* [Extruct API reference](/api-reference/introduction)
* [Authentication](/api-reference/authentication)