agent-search-tool

🔍 Agent Search

Give your AI Agent instant access to the internet

---

What is Agent Search?

Agent Search gives your AI agent the ability to search and read content from 10+ platforms — Twitter/X, Reddit, YouTube, GitHub, Bilibili, LinkedIn, web pages, and more — with a single install command.

The problem it solves:

Agent Search handles all of this transparently. Your agent calls a function, gets back clean readable text.

Quick Start

Paste this into your AI agent (Claude Code, Cursor, OpenAI Assistants, etc.):

Install Agent Search: https://raw.githubusercontent.com/travis-burmaster/agent-search-tool/main/docs/install.md

Installation

pip install agent-search-tool

Supported Platforms

Usage

# Check what's working
agent-search doctor

# Search the web
agent-search search "latest LLM benchmarks 2026"

# Configure optional channels
agent-search configure

Setting Up Twitter/X

Twitter search requires browser cookies. Two ways to set it up:

Option 1 — Auto-extract from your local browser (fastest):

agent-search configure --from-browser chrome

Automatically pulls Twitter cookies from Chrome. Also works with Firefox, Edge, Brave.

Option 2 — Manual via Cookie-Editor:

1. Log into x.com in Chrome
2. Install the Cookie-Editor extension
3. Click the extension → Export → Header String
4. Run:

agent-search configure twitter-cookies "PASTE_COOKIE_STRING_HERE"

Once configured:

twitter search "AI agents 2026" -n 10
twitter read https://x.com/username/status/123456789

Setting Up LinkedIn

LinkedIn uses cookie-based auth via browser automation:

Option 1 — Auto-extract:

agent-search configure --from-browser chrome

Option 2 — Manual via Cookie-Editor:

1. Log into linkedin.com in Chrome
2. Cookie-Editor → Export → Header String
3. Run:

agent-search configure linkedin-cookies "PASTE_COOKIE_STRING_HERE"

Setting Up Other Platforms

Run a Health Check

agent-search doctor

Shows which channels are ready and exactly what to run to fix anything that isn't.

Security

No hardcoded credentials. All cookies and API keys are stored in ~/.agent-search/config.yaml with 0600 permissions (owner read/write only). Credentials never leave your machine.

License

MIT — Copyright (c) 2026 Travis Burmaster