Skip to main content
Use Piloterr through Corsair: one client, typed API calls. Authenticate with the API key from your Piloterr dashboard; the plugin sends it in the x-api-key header. Every operation is a GET against https://api.piloterr.com and each call costs the credits listed on the endpoint page (account.usage and account.getJob are free). Errors answer {“error”: “<message>”}; Piloterr signals rate limits as 401 with a “Rate limit exceeded” message rather than 429, and the plugin retries those twice with core’s exponential backoff (1 s, then 2 s), unless the message reports an exhausted quota. The docs prescribe exponential backoff for 500s only; 400/402/403 are never retried. The fields global parameter filters the response by comma-separated field names with dot notation. soft_fail and is_async are not part of this plugin (a failed call surfaces as an error with Piloterr’s message); poll jobs started elsewhere with account.getJob. web.crawler and web.webunlocker answer a JSON-encoded HTML string, web.rendering the rendered HTML, and web.screenshot a base64-encoded file. web.webunlocker only works for domains on Piloterr’s whitelist. Every operation is described in the official reference: https://docs.piloterr.com/reference What you get:
  • 19 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Enrich a company by domain
Scrape a Google search
See the full list on the API page.

What’s next

API reference

Every piloterr.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.