Skip to main content
Glama
camel-datacircle

camel-datacircle

by waynehamadi
README.md
# camel-datacircle

Find the best GTM APIs. We benchmark all the GTM APIs and we put the results on our website: https://datacircle.dev

This package gives [CAMEL](https://github.com/camel-ai/camel) a toolkit of four tools on Datacircle's open API, https://api.datacircle.dev/v1. You need no key and no account.

```bash
pip install camel-datacircle
```

| Tool | What it gives | Call |
| --- | --- | --- |
| `datacircle_list_apis` | Every GTM API on Datacircle, with its slug, number of plans and providers, and its best plan | `GET /apis` |
| `datacircle_best_plans` | One API's plans, best first by score out of 100, each with its rank and price per 1,000 calls | `GET /apis/{slug}/best` |
| `datacircle_search_plans` | Plans by provider or plan name, on every API or one, sorted by score, provider or price | `GET /plans` |
| `datacircle_provider` | The APIs a provider sells and its rank on each | `GET /providers/{slug}` |

## Use

```python
from camel.agents import ChatAgent
from camel_datacircle import DatacircleToolkit

agent = ChatAgent(
    system_message="Answer from the datacircle tools.",
    tools=DatacircleToolkit().get_tools(),
)
response = agent.step("Which email finder API is best for under $5 per 1,000?")
print(response.msgs[0].content)
```

The agent runs on CAMEL's default model, or the one you give it with `model=ModelFactory.create(...)`. The tools work with `step` and `astep`, beside any other toolkit's, and with a streamed model from CAMEL 0.2.74. CAMEL 0.2.61 and later, Python 3.10 and later.

The same calls without an agent, each giving a dict:

```python
from camel_datacircle import DatacircleToolkit

print(DatacircleToolkit().datacircle_best_plans("email-finder", limit=3))
```

Each plan comes with its rank, provider, plan, score, price per 1,000 (`perThousand`, in dollars) and its page on datacircle.dev, which lists every field. A slug can be a name: `Bright Data` is sent as `bright-data`. An unknown slug or an argument out of range comes back as `{"error": ...}` with the API's words (an unknown API's answer lists every slug), so the model can call again.

## As an MCP server

Like CAMEL's own toolkits, it serves its four tools over MCP:

```bash
python -c "from camel_datacircle import DatacircleToolkit; DatacircleToolkit().run_mcp_server('stdio')"
```

## Network

Each call makes one HTTPS GET to https://api.datacircle.dev/v1 with the tool's arguments and nothing else. The API takes up to 60 calls a minute from one address; the tools wait once, a minute at most, when it asks them to. `DatacircleToolkit(timeout=10)` sets how long a call may take. Every plan is also one file at https://datacircle.dev/datacircle.json.

## Links

- Datacircle: https://datacircle.dev
- The API: https://datacircle.dev/api
- Its spec: https://api.datacircle.dev/v1/openapi.json
- What each key means: https://datacircle.dev/fields

MIT license.