Agent overview
POST /v1/crawl/agent coordinates FairCrawl’s internal tools from one natural-language instruction.
The current loop can call:
scrapemapinteractresearchfinalize
Question-answering agent request
```bash
curl https://api.faircompany.ai/v1/crawl/agent \
-X POST \
-H "Authorization: Bearer fc_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"instruction": "Find Stripe's current standard card pricing and return the answer with sources.",
"max_steps": 6,
"budget_usd": 0.05
}'
```
```ts
const answer = await fc.agent({
instruction: "Find Stripe's current standard card pricing and return the answer with sources.",
max_steps: 6,
budget_usd: 0.05,
});
console.log(answer.answer);
console.log(answer.sources);
```
```python
answer = fc.agent(
"Find Stripe's current standard card pricing and return the answer with sources.",
max_steps=6,
budget_usd=0.05,
)
print(answer.answer)
print(answer.sources)
```
```json
{
"tool": "faircrawl_agent",
"arguments": {
"instruction": "Find Stripe's current standard card pricing and return the answer with sources.",
"max_steps": 6,
"budget_usd": 0.05
}
}
```
Budget model
The agent bills its own coordination cost and then adds the tool work it actually performs. Keep max_steps and budget_usd low until you understand the task class.