Skip to main content

Give your AI Agent eyes to see the entire internet. Search + Read 10+ platforms.

Project description

🔍 Agent Search

Give your AI Agent instant access to the internet

MIT License Python 3.8+ GitHub Stars


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
Reddit 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
Reddit No
YouTube ✅ (transcript) No
Twitter/X Cookie
LinkedIn 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:

  1. Log into x.com in Chrome
  2. Install the Cookie-Editor extension
  3. Click the extension → ExportHeader 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

Platform Command
Reddit 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_search_tool-1.4.8.tar.gz (68.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_search_tool-1.4.8-py3-none-any.whl (72.3 kB view details)

Uploaded Python 3

File details

Details for the file agent_search_tool-1.4.8.tar.gz.

File metadata

  • Download URL: agent_search_tool-1.4.8.tar.gz
  • Upload date:
  • Size: 68.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for agent_search_tool-1.4.8.tar.gz
Algorithm Hash digest
SHA256 a68f10abd003d9c874eb02cab648ed164636b21d8666234c6d721ab28a692899
MD5 66a6b27bd405bf4a082787749f002e8c
BLAKE2b-256 79ac42b3b9c3aacb513a4ca402b662ef2d9d4f9f4805aa86e214ea3bed3bdc0e

See more details on using hashes here.

File details

Details for the file agent_search_tool-1.4.8-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_search_tool-1.4.8-py3-none-any.whl
Algorithm Hash digest
SHA256 750be16a619f3a3c885d60480b43bc3ddfe8713cee24f507be85cd02abf9362a
MD5 e4d356c47412cbc494923ac7dfbb7282
BLAKE2b-256 7a9db80fe9685f0706611b44ad204ba50c47fb10659cc776a87c9f1c6c03ad12

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page