LangChain

The langchain-cloro Python package wraps cloro’s sync monitor endpoints as LangChain tools, so your agents can query AI engines and Google Search and reason over structured results with sources. It’s listed in the LangChain tools index, and the source lives in the langchain-cloro repository.

Prerequisites

Python with LangChain installed
A cloro API key from the dashboard (see Authentication)

Install the package

pip install langchain-cloro

Configure your API key

Set the key as an environment variable:

export CLORO_API_KEY="YOUR_API_KEY"

Or pass it directly when initializing a tool:

from langchain_cloro import CloroGoogleSearch

tool = CloroGoogleSearch(cloro_api_key="YOUR_API_KEY")

Available tools

Tool	Endpoint
`CloroGoogleSearch`	`POST /v1/monitor/google`
`CloroChatGPT`	`POST /v1/monitor/chatgpt`
`CloroGemini`	`POST /v1/monitor/gemini`
`CloroBingAIMode`	`POST /v1/monitor/bing/aimode`

Every tool accepts country (ISO 3166-1 alpha-2, defaults to "US") and include_html. CloroGoogleSearch takes a query plus device ("desktop" or "mobile"), pages (1–10), include_aioverview, and aioverview_markdown; the assistant tools take a prompt and include_markdown, and CloroChatGPT additionally supports include_raw_response and include_search_queries (query fan-out). CloroBingAIMode also takes state for a US state, and its prompt can have a maximum of 3,500 characters after URL encoding (fewer for non-Latin scripts). The package also exports get_countries() for the supported countries, optionally filtered by provider.

Invoke a tool directly

from langchain_cloro import CloroGoogleSearch

tool = CloroGoogleSearch()

results = tool.invoke({
    "query": "best laptops for programming",
    "include_aioverview": True,
    "aioverview_markdown": True,
})

Use with an agent

from langchain.agents import initialize_agent, AgentType
from langchain_openai import OpenAI
from langchain_cloro import CloroGoogleSearch, CloroChatGPT

llm = OpenAI(temperature=0)
tools = [CloroGoogleSearch(), CloroChatGPT()]

agent = initialize_agent(
    tools,
    llm,
    agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION,
    verbose=True,
)

agent.run("What are the latest developments in AI?")

Each tool call is a sync request, billed at the provider’s rate plus the +2 sync surcharge, and counts against your concurrency limits. For large batches (tracking many prompts across engines), use the async API directly instead of looping tool calls.

Introduction

Guides

Integrations

Prerequisites

Install the package

Configure your API key

Available tools

Invoke a tool directly

Use with an agent