Skip to main content
Official repository: GitHub

​
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 discovery with Semantic Search, Lookalike Search, and Deep Search, plus AI Tables, enrichment, scoring, and people/contact workflows.

​
Extruct MCP vs this skill

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 MCPThis skill
AuthOAuth in the clientEXTRUCT_API_TOKEN
SurfaceMCP toolsREST-shaped workflows in prompts
Best forMost users; quick setupPower users; integration and API-heavy work

​
Prerequisites

export EXTRUCT_API_TOKEN="YOUR_API_TOKEN"
Generate tokens in Dashboard API Tokens. For the underlying API setup, see Authentication.

​
Install

​
Claude Code

/plugin marketplace add extruct-ai/skills
/plugin install extruct-skills

​
Codex

$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, install the Extruct skill from GitHub: 
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 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