XSearchLane

Realtime X search for agents.

Open-source MCP server, CLI, and SDK that give coding agents live X search — keyword/semantic search, handle filters, date ranges, and citations. Run locally with your upstream key, or use hosted power on Talocode Cloud.

Why it exists

Agents need social signal, not just static web pages. XSearchLane turns realtime X search into a first-class tool surface:

• MCP-native — plug into OpenCode and other agent hosts
• Local-first — run the open tool with your own provider key
• Hosted path — sell/meter usage under /v1/xsearchlane/*
• Deterministic offline mode — mock provider for tests and CI

Part of Talocode: open tools people trust, hosted power behind them.

Architecture

Agents (OpenCode / CLI / SDK)
        │
        ▼
   XSearchLane core
   runXSearch · runXResearch · MCP
        │
   ┌────┼────────────┐
   ▼    ▼            ▼
  xai  talocode     mock
(direct) (hosted)  (offline)

Demo

Watch the demo: xsearchlane-demo.mp4 (release asset)

# regenerate locally
cd demo && bash make-video.sh

Install

npm install -g @talocode/xsearchlane

Or without install:

npx @talocode/xsearchlane@latest health

Python:

pip install talocode-xsearchlane

Quickstart

CLI

export XAI_API_KEY=...   # direct upstream X search
# or
export TALOCODE_API_KEY=...

xsearchlane search --query "developers complaining about AI code review"
xsearchlane search --query "agent sandbox" --handles simonw,levelsio
xsearchlane research --query "AI coding agent pain points"
xsearchlane health

MCP (OpenCode)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xsearchlane": {
      "type": "local",
      "command": ["npx", "-y", "@talocode/xsearchlane", "mcp"],
      "environment": {
        "XAI_API_KEY": "{env:XAI_API_KEY}"
      }
    }
  }
}

See docs/MCP.md and examples/opencode.json.

SDK

import { runXSearch, XSearchLaneClient } from '@talocode/xsearchlane'

// Local / direct provider
const live = await runXSearch({
  query: 'What are builders saying about agent memory?',
  fromDate: '2026-07-01',
})

// Hosted Talocode Cloud
const client = new XSearchLaneClient({ apiKey: process.env.TALOCODE_API_KEY })
const hosted = await client.search({ query: 'MCP server launch' })

Auth / env

Variable	Purpose
XAI_API_KEY	Direct upstream X search (Responses API x_search)
XAI_BASE_URL	Default https://api.x.ai/v1
XAI_MODEL	Default grok-4.5
TALOCODE_API_KEY	Hosted Talocode API
TALOCODE_BASE_URL	Default https://api.talocode.site
XSEARCHLANE_PROVIDER	auto | xai | talocode | mock

auto picks: xai if XAI_API_KEY is set, else talocode if TALOCODE_API_KEY is set, else mock.

API surface

Local engine

Function	Description
runXSearch(options)	Realtime X search
runXResearch(options)	Research-style brief
health()	Provider status
getPricing() / getCapabilities()	Metadata

Hosted routes (Talocode Cloud)

Method	Path	Credits
GET	/v1/xsearchlane/health	0
GET	/v1/xsearchlane/pricing	0
GET	/v1/xsearchlane/capabilities	0
POST	/v1/xsearchlane/search	15
POST	/v1/xsearchlane/research	40

Auth:

Authorization: Bearer $TALOCODE_API_KEY

MCP tools

Tool	Description
xsearchlane_search	Live X search + filters
xsearchlane_research	Theme/pain-point research brief
xsearchlane_health	Health + active provider
xsearchlane_capabilities	Feature matrix
xsearchlane_pricing	Credit table

CLI

xsearchlane search --query "..." [--handles a,b] [--exclude c] [--from YYYY-MM-DD] [--to YYYY-MM-DD]
xsearchlane research --query "..."
xsearchlane health | pricing | capabilities
xsearchlane mcp

Architecture

Agent (OpenCode / CLI / SDK)
        │
        ▼
   XSearchLane
   ┌──────────────────────────┐
   │ MCP · CLI · SDK · HTTP   │
   └────────────┬─────────────┘
                │
     ┌──────────┼──────────┐
     ▼          ▼          ▼
   xai       talocode     mock
 (direct)   (hosted)   (offline)

Develop

git clone https://github.com/talocode/xsearchlane
cd xsearchlane
npm install
npm run build
npm test
npm run mcp

Related packages

Package	Install
XSearchLane (this package)	npm i @talocode/xsearchlane · pip install talocode-xsearchlane
XProLane	npm i @talocode/xprolane · pip install talocode-xprolane
SearchLane	npm i @talocode/searchlane · pip install talocode-searchlane
StackLane	pip install talocode

Talocode ecosystem

Product	Repo	Notes
XSearchLane	talocode/xsearchlane	(this package) realtime X search MCP/API
XProLane	talocode/xprolane	X Pro setup & signal dashboard planner
SearchLane	talocode/searchlane	Agent web search & research
Tera	talocode/tera	Hosted writing/coding capability API
Codra	talocode/codra	Coding agent runtime
StackLane	talocode/stacklane	Cloud control plane, keys, wallet
GateLane	talocode/gatelane	Policy / gate tooling
ContextLane	talocode/contextlane	Context infrastructure
ScreenLane	talocode/screenlane	Screen/agent UI tooling
MemoryLane	talocode/memorylane	Memory for agents
Tradia	talocode/tradia	Trading tooling
DevTool	talocode/devtool	Developer utilities
Agent Browser	talocode/agent-browser	Browser automation API
InvoiceLane	talocode/invoicelane	Invoicing
GeoLane	talocode/geolane	Geo visibility
ClipLoop	talocode/cliploop	Short-form video loop

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

Links

• GitHub: https://github.com/talocode/xsearchlane
• npm: https://www.npmjs.com/package/@talocode/xsearchlane
• Docs: https://docs.talocode.site
• API base: https://api.talocode.site

License

MIT © Talocode