# DeepAPI Docs — Setup

> Agent-readable DeepAPI docs. Index: https://deepapi.co/llms.txt · OpenAPI: https://deepapi.co/openapi.json · Skill: https://deepapi.co/deepapi-skill/SKILL.md
> Markdown pages: https://deepapi.co/docs/setup.md · https://deepapi.co/docs/reference.md · https://deepapi.co/docs/pricing.md

Paste one prompt. It sets up DeepAPI once for your whole machine — every project, every agent — and runs a safe first test.

## 1. Create an API key

Create a key at https://deepapi.co/api-keys and copy it while it's visible — it is shown only once.

## 2. Paste a prompt into your agent

### Universal setup

One-time global setup — paste into Codex, Claude Code, Cursor, or any agent. Works in every project after that. References auto-update; your SKILL.md edits are preserved.

```text
You are my coding agent. Set up DeepAPI globally on this machine, so it works in every project and every future session.

Credentials:
DEEPAPI_API_BASE_URL=https://deepapi.co
DEEPAPI_API_KEY=<paste the one-time API key here>

Do this:
1. Install on the machine where you run. If you can reach both a local and a remote machine (SSH, remote-execution tools), run `hostname` and ask me which machine to set up BEFORE installing anything.
2. Detect the current OS and shell, then run exactly ONE matching official installer — each takes seconds:
   - Windows PowerShell:
     $installer = Invoke-RestMethod "https://deepapi.co/install.ps1"; & ([scriptblock]::Create([string]$installer)) -BaseUrl "https://deepapi.co" -ApiKey "<paste the one-time API key here>"
   - macOS/Linux bash or zsh:
     curl -fsSL https://deepapi.co/install.sh | DEEPAPI_API_BASE_URL="https://deepapi.co" DEEPAPI_API_KEY="<paste the one-time API key here>" bash
   Do not hand-translate either installer into another shell.
3. The installer handles everything — credentials, the global `deepapi` skill, its local updater, agent memory — and ends with a smoke test.
4. After it succeeds, re-check credentials in THIS session. Only if they are still missing, load them: PowerShell: `. "$HOME/.deepapi/env.ps1"`; bash/zsh: `source ~/.deepapi/env`.
5. Confirm the skill reached this machine: read `$HOME/.agents/skills/deepapi/VERSION.txt` with your own file tools. If it is missing, the installer ran on the wrong machine — re-run it here.
6. If it fails, read the error, fix it, and re-run — installers are idempotent. Setup is complete only when the smoke test status is `succeeded`.
7. Never expose DEEPAPI_API_KEY anywhere — not in code, files, or logs.
8. Check the current balance with `GET https://deepapi.co/v1/balance`. End with a short confirmation: the machine you installed on (its hostname), the skill version, the smoke test result, remaining balance, the top-up link `https://deepapi.co/credits`, that I can stay right here in this chat, and a few things I could ask you next.

Stop and ask before sending email or spending more than the explicit customer spend cap.
```

### Scrape website

Paste when you want the agent to fetch a site.

```text
Use DeepAPI to scrape this website: <url>. Show me the useful content you got.
```

### Email draft

Paste when you want a safe draft, not a send. First use creates your workspace email address — no setup needed.

```text
Use DeepAPI to draft this email: <recipient, subject, message goal>. Draft only — show me the draft, do not send anything.
```

## 3. Watch it run

Every request your agent makes shows up at https://deepapi.co/logs, with its status and cost.

---

Rendered live from the DeepAPI capability catalog. skillVersion: b18c96c6e053