Skip to content
Back to search

omniseek

Your agent seeks what search can't find. A self-hosted perception MCP server that transcribes speech, reads behind logins, sees images and video frames, crosses languages, and remembers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Battam1111/omniseek with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Battam1111/omniseek'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/battam1111--omniseek/badge.svg)](/listings/battam1111--omniseek)

HTML

<a href="/listings/battam1111--omniseek"><img src="/api/listings/battam1111--omniseek/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Docker (recommended)

git clone https://github.com/Battam1111/omniseek.git && cd omniseek
docker compose up -d
docker compose logs omniseek        # bearer token printed on first start
curl -s http://127.0.0.1:8765/healthz

On success, it returns:

{"ok":true}

Point your MCP client at `http://127.0.0.1:8765/mcp` with `Authorization: Bearer <token>`. The token is generated on first start and stored in `~/.omniseek/credentials/omniseek_http.json` (with the compose file, that's `./.omniseek/credentials/omniseek_http.json` on the host).

Two paths from here. The prebuilt core image (`docker pull ghcr.io/battam1111/omniseek`, amd64 + arm64) needs no build and carries every core sense; it is Apache-clean and ships without PDF reading, hearing (ASR + video frames), and login-walled sources. Wanting those extras is what triggers a local build: set `EXTRAS="[pdf,asr,walled]"` and run `docker compose build`, then `up -d` (the first build also fetches headless Chromium; later starts are instant). Optional but recommended: set `OMNISEEK_CONTACT_EMAIL` for a faster lane with Crossref, SEC, and Unpaywall.

Without Docker

python -m venv .venv && . .venv/bin/activate
scripts/bootstrap.sh
python -m omniseek.serve_http

The bare install is the **Core** tier: every keyless API and static source, document reading minus PDF, and the lexical memory index. `pip install "omniseek[pdf,asr,recall,ocr]"` wakes the **Research** tier (PDF, hearing, cross-lingual vectors, OCR); `omniseek[walled]` adds the login-walled tier, which stays off until you bring your own accounts; `omniseek[all]` takes everything. The server prints which senses are online, and which are dormant, at every boot.

On Windows, run `bootstrap.sh` under Git Bash or WSL; Docker is the simplest path. For an always-on Linux service, see [`deploy/omniseek.service`](deploy/omniseek.service).

Prefer stdio? The install also ships an `omniseek` command that speaks MCP over stdio, for clients that launch servers themselves; [`Dockerfile.stdio`](Dockerfile.stdio) wraps the same thing in a container.

OmniSeek binds `127.0.0.1` and requires the bearer token on every request. Do not expose without a reverse proxy ([SECURITY.md](.github/SECURITY.md)).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 131 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- mcp-name: io.github.Battam1111/omniseek -->
  2. <p align="center">
  3. <img src="https://raw.githubusercontent.com/Battam1111/omniseek/main/assets/logo-lockup.png?v=2026-10-11b" width="320" alt="OmniSeek">
  4. </p>
  5. **Give your AI agent the parts of the internet web search doesn't reach.**
  6. OmniSeek is an add-on for AI assistants and agents like Claude Code, Cursor, and Codex that lets them search where web search stops.
  7. - Ask in English, get what people actually said on Bilibili, and Zhihu when you ask for it, with links to the original posts.
  8. - Get the papers a research field is built on, and the recent ones building on them, in one answer.
  9. - Have your agent watch a topic and tell you only what is new since last time.
  10. ```bash
  11. uv tool install omniseek
  12. claude mcp add omniseek -- omniseek
  13. ```
  14. Runs on your own computer. It plugs in through MCP, the standard way AI apps like Claude Code and Cursor add tools. Cursor and Codex: one line each, see [Install](https://github.com/Battam1111/omniseek/blob/main/docs/install.md#connect-your-client).
  15. [![CI](https://github.com/Battam1111/omniseek/actions/workflows/ci.yml/badge.svg)](https://github.com/Battam1111/omniseek/actions/workflows/ci.yml) [![PyPI](https://img.shields.io/pypi/v/omniseek?color=3B82F6&style=flat-square)](https://pypi.org/project/omniseek/) [![License](https://img.shields.io/badge/License-Apache_2.0-3B82F6?style=flat-square)](https://github.com/Battam1111/omniseek/blob/main/LICENSE) ![Python](https://img.shields.io/badge/Python_3.11+-3B82F6?style=flat-square) ![Built for MCP](https://img.shields.io/badge/built_for-MCP-3B82F6?style=flat-square)
  16. **Languages:** English · [中文](https://github.com/Battam1111/omniseek/blob/main/docs/i18n/README_zh.md) · [日本語](https://github.com/Battam1111/omniseek/blob/main/docs/i18n/README_ja.md)
  17. ---
  18. ## See the difference
  19. One real question, asked in Chinese: in Mu Li's 87-minute Bilibili walkthrough of the Transformer paper, what does he say about the paper's writing, and at what minute?
  20. <p align="center">
  21. <a href="https://raw.githubusercontent.com/Battam1111/omniseek/main/assets/demo/seek-en-light.gif?v=2026-11-12#gh-light-mode-only"><picture>
  22. <source media="(max-width: 480px)" srcset="https://raw.githubusercontent.com/Battam1111/omniseek/main/assets/demo/seek-en-light-narrow.gif?v=2026-11-12#gh-light-mode-only">
  23. <img src="https://raw.githubusercontent.com/Battam1111/omniseek/main/assets/demo/seek-en-light.gif?v=2026-11-12#gh-light-mode-only" width="720" alt="The 87-minute video as a timeline. Web search's two answers point near the start: minutes 1 to 8, then 1:50 to 2:30. OmniSeek transcribes all 87 minutes and finds the line at 1:21:51.">
  24. </picture></a>
  25. <a href="https://raw.githubusercontent.com/Battam1111/omniseek/main/assets/demo/seek-en-dark.gif?v=2026-11-12#gh-dark-mode-only"><picture>
  26. <source media="(max-width: 480px)" srcset="https://raw.githubusercontent.com/Battam1111/omniseek/main/assets/demo/seek-en-dark-narrow.gif?v=2026-11-12#gh-dark-mode-only">
  27. <img src="https://raw.githubusercontent.com/Battam1111/omniseek/main/assets/demo/seek-en-dark.gif?v=2026-11-12#gh-dark-mode-only" width="720" alt="The 87-minute video as a timeline. Web search's two answers point near the start: minutes 1 to 8, then 1:50 to 2:30. OmniSeek transcribes all 87 minutes and finds the line at 1:21:51.">
  28. </picture></a>
  29. </p>
  30. - **Web search** answered from other people's notes: "around minutes 1 to 8", and asked again, "between about 1:50 and 2:30". A search for his exact words found nothing.
  31. - **With OmniSeek**, the agent transcribed all 87 minutes locally and found the line at [1:21:51](https://www.bilibili.com/video/BV1pu411o7BE?t=4911): 「这篇文章的写作是非常简洁的,因为就是说他每一句话就基本上在讲一件事情。」 "The writing of this paper is very concise: basically, every sentence says one thing." Asked again, it gave the same line from cache in 0.1 s.
  32. [The full comparison on three questions](https://github.com/Battam1111/omniseek/blob/main/docs/compare.md), with sources, dates, and a short video.
  33. ---
  34. ## What your agent can reach
  35. - **Chinese communities**: Bilibili videos and comments, Zhihu answers when you ask for them, recent V2EX threads, all with links to the posts. More: [Bilibili](https://battam1111.github.io/omniseek/bilibili-mcp.html), [Zhihu](https://battam1111.github.io/omniseek/zhihu-mcp.html)
  36. - **Across languages**: ask in English, search in Chinese, answer in English. And the reverse. [More](https://battam1111.github.io/omniseek/cross-lingual-search-mcp.html)
  37. - **Podcasts and videos**: turns speech into text on your own computer and quotes it with the minute (optional add-on). [More](https://battam1111.github.io/omniseek/podcast-transcription-mcp.html)
  38. - **Research papers**: which papers a field is built on and which recent ones cite them. [More](https://battam1111.github.io/omniseek/citation-graph-mcp.html)
  39. - **New since last time**: save a search once; each rerun shows only what is new. [More](https://battam1111.github.io/omniseek/research-monitoring-mcp.html)
  40. - **Sites you log in to**: if you switch it on, your agent reads them through your own browser login. Off by default. [More](https://github.com/Battam1111/omniseek/blob/main/docs/walled-sources.md)
  41. It also keeps what it finds in a local index on your computer, so later searches start from what it already knows.
  42. ---
  43. ## Install
  44. The two commands above are all you need, with Python 3.11 or newer ([uv](https://docs.astral.sh/uv/) installs it if you don't have it). Your AI app starts OmniSeek when it needs it. Nothing to keep running, no port to open.
  45. Cursor, Codex, pipx, Docker, and the optional add-ons (podcast transcription, PDF reading, sites you log in to) are in **[Install](https://github.com/Battam1111/omniseek/blob/main/docs/install.md)**.
  46. ---
  47. ## Your data, your logins
  48. OmniSeek runs on your computer. There is no OmniSeek cloud, no account, no telemetry: your agent's searches go straight to the sites you turned on. Public sites are on by default. Sites that need a login are off until you switch them on, and then they use the login already in your own browser; OmniSeek never sees your password. What it builds up as you use it stays in local files you own.
  49. OmniSeek has no AI model of its own and sends nothing to a server of ours. Your agent does the thinking; OmniSeek goes and gets things. Settings: [Configuration](https://github.com/Battam1111/omniseek/blob/main/docs/configuration.md).
  50. ---
  51. ## Tools
  52. Your agent starts with `omniseek_search`; `omniseek_sources` shows what is available. The rest, from paper maps to saved searches and the notes your agent keeps (`omniseek_ruling`, `omniseek_statement`):
  53. | Tool | What it does |
  54. |------|-------------|
  55. | `omniseek_search` | Search the whole catalog at once, remove duplicates, rank. Works across languages. |
  56. | `omniseek_read` | Turn any URL or document (web page, PDF, arXiv) into clean text. |
  57. | `omniseek_view` | Look at images, document figures, and video frames. |
  58. | `omniseek_transcribe` | Transcribe audio or video locally, English and Chinese, from any timestamp. |
  59. | `omniseek_field_skeleton` | Map a research field's citations: the papers it is built on and the recent ones. |
  60. | `omniseek_resolve_identity` | Match a person's name to candidate author IDs across databases. |
  61. | `omniseek_coauthors` | Map a researcher's collaborators by number of joint papers. |
  62. | `omniseek_institution_cohort` | List who actively publishes at a lab, within a field. |
  63. | `omniseek_paper_enrich` | Open-access PDF, retraction status, and citation count for a paper. |
  64. | `omniseek_paper_recommend` | Similar papers (SPECTER embeddings) that keyword search misses. |
  65. | `omniseek_graph` | Query the local graph of what OmniSeek has found: find, neighborhood, between, since, similar. |
  66. | `omniseek_sensor` | Saved searches that rerun on a schedule and report only what is new. |
  67. | `omniseek_ruling` | Record that two entries are (or are not) the same person or thing. |
  68. | `omniseek_statement` | Record a directed relation between two entries. |
  69. | `omniseek_curator_act` | Propose, test, add, or retire a source. |
  70. | `omniseek_curator_view` | Read the queue of proposed sources or one source's report. |
  71. | `omniseek_gather` | Run several tools in parallel, one response. |
  72. | `omniseek_sources` | List sources by domain, region, capability, and health. |
  73. One MCP prompt comes with them: `investigate(target, shape, context)`, a ready-made investigation recipe, where `shape` is `person`, `lab`, `field`, `product` or `chase` and the optional `context` narrows the angle.
  74. Every parameter, and what each returned field means: **[TOOLS.md](https://github.com/Battam1111/omniseek/blob/main/docs/TOOLS.md)**. Each tool's own description ends by pointing at its section there.
  75. ---
  76. ## More
  77. [Worked examples, real outputs](https://github.com/Battam1111/omniseek/blob/main/docs/examples.md) · [A full case study](https://github.com/Battam1111/omniseek/blob/main/docs/case-study.md) · [FAQ](https://github.com/Battam1111/omniseek/blob/main/docs/faq.md), including how it differs from Exa and Tavily · [All sources](https://github.com/Battam1111/omniseek/blob/main/docs/sources.md) · [Source health, updated weekly](https://github.com/Battam1111/omniseek/blob/health-data/README.md)
  78. **[How we test these claims](https://github.com/Battam1111/omniseek/blob/main/bench/DESIGN.md)**: a test only counts if we first checked that plain web search could not find its answer on the first page ([latest results](https://github.com/Battam1111/omniseek/blob/health-data/bench/RESULTS.md)). Using Claude Code? [`skills/omniseek-investigate`](https://github.com/Battam1111/omniseek/blob/main/skills/omniseek-investigate/SKILL.md) is a ready-made research method: search wide, narrow in, add structure.
  79. ---
  80. ## Contributing
  81. See [CONTRIBUTING.md](https://github.com/Battam1111/omniseek/blob/main/.github/CONTRIBUTING.md): a new source has to find something plain web search doesn't. Fixing a source that stopped working is always welcome.
  82. By participating you agree to the [Code of Conduct](https://github.com/Battam1111/omniseek/blob/main/.github/CODE_OF_CONDUCT.md).
  83. <div align="center">
  84. ---
  85. **Give your AI agent the parts of the internet web search doesn't reach.**
  86. [Apache-2.0](https://github.com/Battam1111/omniseek/blob/main/LICENSE) · [NOTICE](https://github.com/Battam1111/omniseek/blob/main/NOTICE) · [Security](https://github.com/Battam1111/omniseek/blob/main/.github/SECURITY.md) · [Cite](https://github.com/Battam1111/omniseek/blob/main/CITATION.cff)
  87. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.