XSearchLane

Realtime X search for agents — natural-language answers, handle/date filters, and citations via Talocode Cloud.

Part of Talocode — open tools people trust; hosted power under docs.talocode.site.

Why XSearchLane?

Agents need live social signal, not only static web pages:

• Realtime X search — keyword/semantic questions over posts and threads
• Filters — allowed/excluded handles, date ranges, optional media understanding
• Citations when the upstream provider returns them
• Credit metering on Talocode Cloud (15 search / 40 research)
• Same contract — Python SDK, npm SDK, CLI, MCP, and HTTP

Local Node tooling can also call an upstream X search provider directly with XAI_API_KEY. This Python package targets the hosted Talocode API surface.

Install

pip install talocode-xsearchlane

Requires Python 3.10+. Stdlib only (no extra runtime deps).

Quickstart

import os
from xsearchlane import XSearchLaneClient

client = XSearchLaneClient(
    api_key=os.environ["TALOCODE_API_KEY"],
    # base_url defaults to https://api.talocode.site
)

result = client.search(query="developers complaining about AI code review")
print(result.get("answer"))
for c in result.get("citations", []):
    print(c.get("url"), c.get("title"))

brief = client.research(query="AI coding agent pain points")
print(brief.get("answer"))

Environment

export TALOCODE_API_KEY=your_key
export TALOCODE_BASE_URL=https://api.talocode.site

Auth header:

Authorization: Bearer $TALOCODE_API_KEY

API surface / credits

Client methods

client.health()
client.pricing()
client.capabilities()
client.search(
    query=...,
    allowed_handles=None,
    excluded_handles=None,
    from_date=None,  # YYYY-MM-DD
    to_date=None,
    enable_image_understanding=None,
    enable_video_understanding=None,
)
client.research(query=..., allowed_handles=None, from_date=None, to_date=None)

• XSearchLaneError — raised on HTTP failures (status, code when present)
• create_xsearchlane_client(...) — factory alias

CLI

xsearchlane health
xsearchlane pricing
xsearchlane capabilities
xsearchlane search --query "AI agent sandbox"
xsearchlane research --query "review bottleneck AI PRs"
xsearchlane search --query "MCP tools" --handles simonw --from 2026-07-01

Node / MCP / full product

npm install -g @talocode/xsearchlane
xsearchlane search --query "..."
xsearchlane mcp

OpenCode MCP example: see repo examples/opencode.json and docs/MCP.md.

Repo: github.com/talocode/xsearchlane

Related packages

Talocode ecosystem

More: github.com/talocode · talocode.site · docs.talocode.site

Links

• PyPI: https://pypi.org/project/talocode-xsearchlane/
• npm: https://www.npmjs.com/package/@talocode/xsearchlane
• Source: https://github.com/talocode/xsearchlane
• Docs: https://docs.talocode.site
• Issues: https://github.com/talocode/xsearchlane/issues

License

MIT © Talocode