langchain-geekflare

LangChain tools for the Geekflare API: live web search (including full Google SERP results), scraping public pages to Markdown or structured JSON, page metadata, brand data, screenshots, URL-to-PDF, and website diagnostics (uptime, DNS, DNSSEC, TLS, redirects, broken links, load time, mixed content, Lighthouse).

Built on the official Python SDK, geekflare-api.

Installation

pip install -U langchain-geekflare

Setup

Get an API key at dash.geekflare.com (free tier available) and set it as an environment variable:

export GEEKFLARE_API_KEY="your-api-key"

You can also pass it directly: GeekflareSearch(geekflare_api_key="...").

Tools

Each tool returns the API's JSON response as a dict. API errors (invalid key, no credits, unreachable site) come back to the agent as a short error message instead of raising.

Usage

Call a tool directly

from langchain_geekflare import GeekflareSearch, GeekflareScrape

search = GeekflareSearch()
results = search.invoke({"query": "latest stable python release", "limit": 5})

scrape = GeekflareScrape()
page = scrape.invoke({"url": "https://example.com", "formats": ["markdown"]})

Google results page for a city:

search.invoke({
    "query": "best project management software",
    "serp": True,
    "city": "London,England,United Kingdom",
})

Use with an agent

from langchain.agents import create_agent
from langchain_geekflare import (
    GeekflareSearch,
    GeekflareScrape,
    GeekflareTlsScan,
    GeekflareDnsRecords,
)

agent = create_agent(
    model="anthropic:claude-sonnet-5-5",
    tools=[GeekflareSearch(), GeekflareScrape(), GeekflareTlsScan(), GeekflareDnsRecords()],
)

agent.invoke({"messages": [{"role": "user", "content": "Is the TLS setup on example.com healthy?"}]})

Async is supported on every tool: await tool.ainvoke({...}).

Notes

• Every call spends Geekflare credits on your account; see pricing.
• Use the tools for publicly accessible pages only.
• The tools send the URLs, queries, and options you pass to api.geekflare.com. See the Geekflare privacy policy.

Development

uv venv --python 3.12 && uv pip install -e . --group test
pytest --disable-socket --allow-unix-socket tests/unit_tests
GEEKFLARE_API_KEY=... pytest tests/integration_tests

Links

• API docs: https://docs.geekflare.com
• Python SDK: https://github.com/geekflare/geekflare-api-python
• MCP server: https://docs.geekflare.com/mcp/overview