🔍 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:
| Pain Point | Reality |
|---|---|
| Twitter/X API | Paid, $215/mo for moderate use |
| Server IPs get 403'd | |
| YouTube transcripts | No official API |
| GitHub search | Auth required, rate limited |
| Web scraping | Returns raw HTML, not readable content |
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
| Platform | Search | Read | Auth Required |
|---|---|---|---|
| Web | ✅ | ✅ | No |
| GitHub | ✅ | ✅ | Optional |
| ✅ | ✅ | No | |
| YouTube | ❌ | ✅ (transcript) | No |
| Twitter/X | ✅ | ✅ | Cookie |
| ❌ | ✅ | Cookie | |
| Bilibili | ✅ | ✅ | Cookie |
| Exa Search | ✅ | ✅ | API key |
| RSS | ❌ | ✅ | No |
| V2EX | ✅ | ✅ | No |
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:
- Log into x.com in Chrome
- Install the Cookie-Editor extension
- Click the extension → Export → Header String
- 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:
- Log into linkedin.com in Chrome
- Cookie-Editor → Export → Header String
- Run:
agent-search configure linkedin-cookies "PASTE_COOKIE_STRING_HERE"
Setting Up Other Platforms
| Platform | Command |
|---|---|
Works out of the box — rdt search "query" |
|
| YouTube | Works out of the box — yt-dlp --dump-json URL |
| GitHub | Works out of the box — gh repo view owner/repo |
| Web | Works out of the box — curl https://r.jina.ai/URL |
| Exa Search | agent-search configure exa-key YOUR_KEY |
| Bilibili | agent-search configure --from-browser chrome |
| Xiaoyuzhou Podcast | agent-search configure groq-key gsk_... |
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
Metadata
Release files for agent-search-tool 1.4.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agent_search_tool-1.4.8.tar.gz | 68.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_search_tool-1.4.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 140.3 kB
Release files / agent_search_tool-1.4.8.tar.gz
| Download URL | agent_search_tool-1.4.8.tar.gz |
|---|---|
| Size | 68.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a68f10abd003d9c874eb02cab648ed164636b21d8666234c6d721ab28a692899
|
|
BLAKE2b-256 checksum How to use checksums |
79ac42b3b9c3aacb513a4ca402b662ef2d9d4f9f4805aa86e214ea3bed3bdc0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / agent_search_tool-1.4.8-py3-none-any.whl
| Download URL | agent_search_tool-1.4.8-py3-none-any.whl |
|---|---|
| Size | 72.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
750be16a619f3a3c885d60480b43bc3ddfe8713cee24f507be85cd02abf9362a
|
|
BLAKE2b-256 checksum How to use checksums |
7a9db80fe9685f0706611b44ad204ba50c47fb10659cc776a87c9f1c6c03ad12
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|