Skip to main content

llm-tools-datacircle

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

This plugin gives LLM a Datacircle toolbox of four tools on Datacircle's open API, https://api.datacircle.dev/v1. You need no key and no account.

llm install llm-tools-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

llm -T Datacircle "Which email finder API is best for under \$5 per 1,000?" --td

--td shows each call and what it gave. Any model of yours that LLM can run with tools works; llm chat -T Datacircle keeps the tools for a whole chat, and llm tools lists them. -T 'Datacircle(timeout=10)' sets how long a call may take, in seconds.

From Python:

import llm
from llm_tools_datacircle import Datacircle

model = llm.get_model()  # your default model: `llm models default` sets it
print(model.chain("Who is the best phone finder API?", tools=[Datacircle()]).text())

The same calls without a model, each giving a dict:

from llm_tools_datacircle import Datacircle

print(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, an argument out of range or the API out of reach raises DatacircleError with the API's words (an unknown API's answer lists every slug); LLM gives the model those words as the tool's answer, so it can call again.

LLM 0.26 and later, Python 3.10 and later.

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. Every plan is also one file at https://datacircle.dev/datacircle.json.

MIT license.

Metadata

Release files for llm-tools-datacircle 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for llm-tools-datacircle 0.1.0
File Size Uploaded Provenance Actions
llm_tools_datacircle-0.1.0.tar.gz 8.3 kB Without provenance Details for llm_tools_datacircle-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for llm-tools-datacircle 0.1.0
File Interpreter ABI Platform Actions
llm_tools_datacircle-0.1.0-py3-none-any.whl Python 3 none any Details for llm_tools_datacircle-0.1.0-py3-none-any.whl

Total release size: 15.5 kB

Release files / llm_tools_datacircle-0.1.0.tar.gz

Download URL llm_tools_datacircle-0.1.0.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c5974b773baa8acfeea96fd050e61b6987969b300eb1b458e4c55ae691192b21
BLAKE2b-256 checksum
How to use checksums
4f7e2d912870f11142301f582425a837b421e7f105d8d3e79d772205d212669e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / llm_tools_datacircle-0.1.0-py3-none-any.whl

Download URL llm_tools_datacircle-0.1.0-py3-none-any.whl
Size 7.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
38e55345832a78c26fbc61b85ea9a32f20dc99c307a959b808bc11f4416728ae
BLAKE2b-256 checksum
How to use checksums
eb7e5637c5c48839694b1206ff2e4ae26a3da21c2c7b850908189f4d5e1eb795
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for llm-tools-datacircle 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page