citetrail
Citetrail
Локальная память с подтверждённым происхождением о том, что видел ваш браузер — каждое воспоминание несёт URL, заголовок и временную метку, откуда оно взялось.
Citetrail захватывает страницы, которые вы действительно читали, хранит их на вашем компьютере и делает их доступными для поиска — вами и вашими ИИ-агентами через MCP. Когда агент использует что-то, что он там нашёл, он может точно указать, откуда это взялось.
Статус: предрелизная версия. Перед установкой см. Статус проекта.
Лицензия: Apache-2.0
Локально по умолчанию. Никакого аккаунта, сервера и загрузок. Заблокированные страницы не сохраняются (fail closed).
Проблема, которую решает Citetrail
Вы открыли шесть вкладок, закрыли их, и теперь вашему агенту-программисту нужна информация из четвёртой вкладки. Ваши варианты сегодня: вставить её снова, позволить агенту заново искать в открытом интернете и надеяться, что он попадёт на ту же страницу, или принять ответ без источника.
История браузера знает, что вы посетили URL. Она не знает, что было на странице, и не может сообщить это вашему агенту. Citetrail устраняет этот разрыв:
История браузера | Citetrail |
Список URL | Содержимое, которое вы действительно читали, сохранённое |
Поиск по заголовку, приблизительно | Поиск по тому, что было сказано на странице |
Невидимо для ваших инструментов | Доступно для запросов агентам через MCP |
Нет понятия «почему это здесь» | Каждая запись несёт своё происхождение |
Всё подряд | Только разрешённые страницы; чёрный список блокирует по умолчанию |
Related MCP server: knowledge-base
Что здесь означает «подтверждённое происхождение»
Каждый сохранённый фрагмент хранит ограниченную ссылку: исходный URL, заголовок страницы, временную метку захвата и позицию на странице. При извлечении возвращается фрагмент и эта ссылка вместе — их нельзя разделить. Агент, отвечающий из Citetrail, всегда может сказать, откуда он это взял, а вы всегда можете открыть оригинал.
Если источник исчез, Citetrail сообщает, что источник исчез. Он не выдаёт фрагмент за актуальный, как будто он всё ещё доступен.
Быстрый старт
git clone https://github.com/anonb3ll/citetrail
cd citetrail
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/citetrail init
# 2. Search the local store
.venv/bin/citetrail search "retry backoff"
# Optional: block a sensitive hostname before it can be stored
.venv/bin/citetrail block bank.example.test
# 3. Point an agent at the same local store over MCP
.venv/bin/citetrail mcp --stdioХранилище по умолчанию — ~/.local/share/citetrail. Установите CITETRAIL_STORE или передайте --store PATH, чтобы использовать другую локальную директорию. См. docs/extension.md, чтобы загрузить распакованный адаптер Chromium.
Документация
Руководство | Описание |
Индекс документации | |
Команды CLI и структура хранилища | |
Схема инструментов MCP и регистрация | |
Настройка расширения Chromium | |
Чёрный список и поведение fail-closed | |
Опциональная интеграция с Runroom |
Часто задаваемые вопросы
Как разрешить моему ИИ-агенту искать в истории браузера?
Запустите локальный MCP-сервер и зарегистрируйте его у своего агента. Агент обращается к Citetrail как к любому другому MCP-инструменту и получает фрагменты с прикреплёнными источниками. Он никогда не получает прямого доступа к вашему браузеру или профилю.
Где хранятся мои данные и загружается ли что-то?
На вашем компьютере, в локальной базе данных, которую вы можете удалить в любой момент. У Citetrail нет сервера, и он ничего не загружает. См. docs/privacy.md.
Как запретить захват моего банка, почты или рабочей интрасети?
Чёрный список. Он проверяется перед захватом и блокирует по умолчанию — если правила не могут быть оценены для страницы, эта страница не захватывается. Добавьте хост с помощью citetrail block bank.example.test. Захват только по белому списку отложен.
Может ли агент цитировать источник, который он на самом деле не читал?
Не из Citetrail. Ссылка путешествует вместе с фрагментом; не существует API, который возвращает текст без его происхождения.
Что произойдёт, если я офлайн или страница исчезла?
Поиск работает офлайн по уже захваченным данным. Если исходный URL недоступен, результаты помечаются как таковые, а не молча выдаются за актуальные. Недоступные и заблокированные по соображениям конфиденциальности состояния честно сообщаются, а не скрываются.
Это приложение для заметок или «второй мозг»?
Нет. Citetrail захватывает и извлекает; он не организует ваше мышление, не строит граф знаний и не требует от вас ничего поддерживать. Это инфраструктура для инструментов, которым нужно знать, что вы читали.
Работает ли это в любом браузере?
Расширение в первую очередь ориентировано на браузеры на основе Chromium. Нативный мост между расширением и локальным сервисом имеет реальные ограничения — см. docs/limitations.md.
Чем Citetrail не является
Не облачный сервис и не сервис синхронизации. Один компьютер — одно хранилище.
Не система PKM и не заметки.
Не клинический инструмент, не инструмент для благополучия и не отслеживания внимания. Он не делает никаких заявлений о вашем когнитивном состоянии.
Не парсер. Он захватывает страницы, которые вы сами посетили, по вашим правилам.
Не мобильное приложение.
См. docs/limitations.md и docs/private-exclusions.md.
Связанный проект
Runroom координирует передачу задач между ИИ-агентами и людьми с помощью контрольных точек проверки и аудиторского следа. Оба проекта независимы, и ни один не требует другого; опциональная интеграция показывает ссылку Citetrail, передаваемую в управляемую задачу Runroom.
Участие
Прочтите CONTRIBUTING.md и CODE_OF_CONDUCT.md. Сообщайте об уязвимостях конфиденциально — см. SECURITY.md.
Статус проекта
Предрелизная версия, до 1.0. Интерфейсы будут меняться. Citetrail опубликован, чтобы выяснить, нужен ли он другим людям — если вы попробуете, расскажите нам, что вы пытались вспомнить и получилось ли у вас.
Лицензия
Apache License 2.0. Авторские права 2026, участники Citetrail.
Available Tools
1 toolcitetrail_searchC
Search local captures with inseparable provenance.
Inputs: query (required), source_state.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap. The purpose of citetrail_search is singular and unambiguous.
The single tool name 'citetrail_search' follows a clear object-action pattern, and with only one tool there is no inconsistency to evaluate.
A single search tool feels insufficient for a server named 'citetrail', which implies a broader capture management lifecycle. One tool is too thin for the apparent scope of the domain.
The server only exposes search; there are no create, retrieve, update, delete, or list operations for captures. This leaves agents unable to ingest or manage captures, creating significant gaps and dead ends.
Maintenance
Related MCP Connectors
Scrape, crawl and search the web for AI agents via MCP.
Hosted agent memory: store, search, and recall facts across sessions from any MCP client.
Agentic search over your Dewey document collections from any MCP-compatible client.
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform web searches with full content retrieval and multi-engine provenance, including trust scoring and local corpus persistence, via MCP integration.4Apache 2.0
- FlicenseNot gradedqualityBmaintenanceEnables local full-text and semantic search over saved content, providing search and retrieval capabilities via MCP for AI assistants.-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to search local text and Markdown collections using keyword BM25, semantic vector search, and reranked hybrid retrieval, with full-document retrieval and collection status over MCP.259 PyPI2MIT
- AlicenseBqualityCmaintenanceEnables agents to query a self-hosted, locally indexed web corpus through MCP tools for keyword, neural, or hybrid search, to fetch clean text from already-indexed URLs, and to discover pages similar to an indexed URL.3MIT