Documentation Index
Fetch the complete documentation index at: https://docs.langchain.com/llms.txt
Use this file to discover all available pages before exploring further.
cloro provides tools for monitoring AI platforms and search engines with structured data extraction.
Setup
Install the langchain-cloro package:
pip install -U langchain-cloro
Get your API key from the cloro dashboard and set it as an environment variable:
import os
os.environ["CLORO_API_KEY"] = "your-api-key"
Google Search scraper
Extract structured data from Google Search results, including organic results, People Also Ask questions, related searches, and optional AI Overview.
from langchain_cloro import CloroGoogleSearch
tool = CloroGoogleSearch()
result = tool.invoke({"query": "best laptops for programming"})
Include AI Overview
result = tool.invoke({
"query": "best laptops for programming",
"include_aioverview": True,
"aioverview_markdown": True
})
Custom parameters
result = tool.invoke({
"query": "python tutorials",
"country": "GB", # UK results
"device": "mobile", # or "desktop"
"pages": 3 # Number of pages (1-20)
})
ChatGPT scraper
Extract structured data from ChatGPT with shopping cards, entity extraction, and advanced features for monitoring products, prices, and brand mentions.
from langchain_cloro import CloroChatGPT
tool = CloroChatGPT()
result = tool.invoke({"prompt": "What are the best sneakers under $100?"})
Include raw response and search queries
result = tool.invoke({
"prompt": "best running shoes 2024",
"include_raw_response": True,
"include_search_queries": True,
"country": "US"
})
Gemini scraper
Extract structured data from Google’s Gemini AI with source citations and confidence levels.
from langchain_cloro import CloroGemini
tool = CloroGemini()
result = tool.invoke({"prompt": "Explain quantum entanglement"})
Include markdown response
result = tool.invoke({
"prompt": "What is machine learning?",
"include_markdown": True,
"country": "US"
})
Perplexity scraper
Extract comprehensive structured data from Perplexity AI with real-time web sources, shopping products, media content, and travel information.
from langchain_cloro import CloroPerplexity
tool = CloroPerplexity()
result = tool.invoke({"prompt": "Best hotels in San Francisco"})
Grok scraper
Extract comprehensive structured data from Grok with real-time web sources and enhanced source metadata including preview text, creator details, and images.
from langchain_cloro import CloroGrok
tool = CloroGrok()
result = tool.invoke({"prompt": "Latest news about AI"})
Copilot scraper
Extract structured data from Microsoft Copilot with source citations.
from langchain_cloro import CloroCopilot
tool = CloroCopilot()
result = tool.invoke({"prompt": "What is the capital of France?"})
Use with agents
All cloro tools can be used with LangChain agents:
from langchain.agents import AgentExecutor, create_tool_calling_agent
from langchain_core.prompts import ChatPromptTemplate
from langchain_openai import ChatOpenAI
from langchain_cloro import CloroGoogleSearch, CloroChatGPT
# Initialize tools
search_tool = CloroGoogleSearch()
chatgpt_tool = CloroChatGPT()
tools = [search_tool, chatgpt_tool]
# Create agent
llm = ChatOpenAI(model="gpt-4", temperature=0)
prompt = ChatPromptTemplate.from_messages([
("system", "You are a helpful assistant"),
("human", "{input}"),
("placeholder", "{agent_scratchpad}"),
])
agent = create_tool_calling_agent(llm, tools, prompt)
agent_executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
# Run agent
result = agent_executor.invoke({"input": "Search for information about AI trends and summarize what you find"})
All cloro tools return JSON-formatted responses with structured data:
import json
result = tool.invoke({"query": "python programming"})
data = json.loads(result)
# Access structured results
if "result" in data:
if "organicResults" in data["result"]:
for item in data["result"]["organicResults"]:
print(f"{item['title']}: {item['link']}")
API reference
CloroGoogleSearch: Google Search with AI Overview support
CloroChatGPT: ChatGPT monitoring with shopping cards
CloroGemini: Google Gemini AI with citations
CloroPerplexity: Perplexity AI with sources and media
CloroGrok: Grok with enhanced metadata
CloroCopilot: Microsoft Copilot monitoring
For more details, visit the cloro documentation.