cli-anything-zotero — Zotero для ИИ-агентов
cli-anything-zotero
CLI zotero-cli управляет локальной библиотекой Zotero: поиск, импорт по DOI, экспорт BibTeX, PDF, заметки, цитаты в DOCX
- 142 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Агент получает привилегированный JavaScript внутри Zotero и может менять и удалять данные библиотеки
- Режим выполнения произвольного кода открывает полный доступ к библиотеке и подключенным файлам
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/cli-anything-zoteroОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает привилегированный JavaScript внутри Zotero и может менять и удалять данные библиотеки
- Режим выполнения произвольного кода открывает полный доступ к библиотеке и подключенным файлам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
cli-anything-zotero ставит команду `zotero-cli`, через которую агент работает с локальной библиотекой Zotero. Доступ идет через JS Bridge, легкий плагин Zotero с привилегированным JavaScript-endpoint, поэтому настольный Zotero должен быть запущен. Ключ API и интернет для записи не требуются. Команды покрывают поиск по ключевым словам и полному тексту PDF, дерево коллекций и теги. Импорт принимает DOI, PMID, файлы RIS и BibTeX и JSON, экспорт отдает BibTeX, CSL-JSON, RIS, CSV и оформленные цитаты. Агент прикрепляет PDF, находит недостающие файлы в сети, ищет по аннотациям, обновляет метаданные, пишет заметки и запускает синхронизацию. Для текстов в Word есть команды `docx`: заглушки `{{zotero:ITEMKEY}}` превращаются в статичные цитаты с библиографией либо в обновляемые поля Zotero, если на машине стоят LibreOffice и его плагин Zotero. Режим `auto` выбирает динамический вариант, когда он доступен, а `docx doctor` проверяет готовность. Есть и семантический поиск по локальным эмбеддингам, а в режиме для опытных можно выполнить свой JavaScript в Zotero.
Для кого. Исследователям и студентам с большой библиотекой в Zotero, которые поручают агенту рутину: импорт источников, поиск PDF, экспорт и расстановку цитат.
Подходит, если
- Нужно найти в библиотеке статьи про диабет и болезни почек по тексту PDF
- Источник по DOI следует добавить в конкретную коллекцию одной фразой
- Для диссертации потребуется экспорт коллекции в BibTeX или CSL-JSON
- У части записей нет PDF, и агент должен найти их и прикрепить
- Черновик в DOCX содержит заглушки цитат, которые надо превратить в настоящие ссылки
Не подходит, если
- Нужна облачная работа без запущенного Zotero: инструмент автоматизирует локальный клиент
- Нужен MCP-сервер: после версии 0.9.5 развитие идет как CLI и SDK, а MCP заморожен
- Нужны обновляемые поля цитат на машине без LibreOffice: подойдет только статичный режим
- Библиотека хранит чужие данные без резервной копии: операции записи меняют метаданные и заметки
Пример запроса к агенту
Найди в моей библиотеке Zotero статьи про диабет и болезни почек и экспортируй их коллекцию в BibTeX.Ограничения
Нужны Python 3.10 и новее, Zotero 7 и новее в запущенном виде, а также плагин CLI Bridge, который ставит команда `zotero-cli app install-plugin`. Через плагин агент получает привилегированный JavaScript внутри Zotero, и режим выполнения произвольного кода дает полный доступ к библиотеке.
Динамические цитаты в Word требуют LibreOffice и плагина Zotero для него, полностью они проверены на macOS. Поддержка MCP остановилась на версии 0.9.5, дальше только CLI и SDK. Перед массовыми правками стоит сделать копию библиотеки.
Как отключить. Выполните `pip uninstall cli-anything-zotero` и удалите плагин CLI Bridge в окне дополнений Zotero. Библиотека Zotero при этом останется нетронутой.
Частые вопросы
Как поставить cli-anything-zotero?
Выполните `pip install cli-anything-zotero`, затем `zotero-cli app install-plugin` для плагина CLI Bridge. Zotero 7 или новее должен быть запущен, Python нужен версии 3.10 и выше.
Нужен ли ключ API Zotero?
Нет. Операции записи идут локально через JS Bridge, ключ и интернет для них не требуются. Облачный API инструмент не заменяет.
Что с MCP?
Версия 0.9.5 осталась последней с командой `zotero-mcp` и дополнением `[mcp]`. Новые релизы выходят как CLI и SDK, а пользователям MCP советуют зафиксировать `cli-anything-zotero[mcp]==0.9.5` или взять ветку `legacy/mcp`.
Как вставить цитаты в DOCX?
Агент пишет в тексте заглушки `{{zotero:ITEMKEY}}`, затем команда `zotero-cli --json docx cite draft.docx --output draft-cited.docx --mode auto --force` превращает их в цитаты. Динамический режим требует LibreOffice и плагин Zotero, статичный не требует.
Чем отличается от обычного Zotero MCP?
Здесь доступ идет через локальный клиент и JS Bridge с полными операциями записи и цитатами в DOCX. Серверы Zotero MCP из каталога работают через облачный API или читают базу.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер для Zotero: поиск по словам и смыслу, цитаты из PDF со страницами, ссылки в CSL и добавление статей по DOI
Скилл управляет библиотекой Zotero из терминала: поиск, добавление, заметки, коллекции и слияние дубликатов.
Локальный MCP-сервер позволяет агенту искать и читать вашу библиотеку Zotero, хранилище Obsidian и Apple Notes через ядро на C++
Скилл связывает агента с вашей библиотекой Zotero через локальный JSON CLI, без MCP-сервера: поиск, PDF, аннотации и заметки.
Плагин Zotero со встроенным MCP-сервером: агент ищет по библиотеке, читает PDF и заметки, работает с аннотациями и метаданными
Набор CLI для агентов на Windows: управление WPS Office и Microsoft Office, Photoshop и Illustrator через COM, а также Zotero с 27 академическими скиллами
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| cli-anything-zotero — Zotero для ИИ-агентов (эта карточка) | нет | 142 | ||
| Zotero MCP | нет | не нужна | 1 278 | MCP-сервер Zotero с поиском и чтением, без CLI и цитат в DOCX |
| Zotero Research Assistant Skill | нет | 98 | скилл для исследовательских задач, без команд управления библиотекой |
Коротко о README
README делит материал на раздел для непрограммистов, возможности, сравнение статичных и динамических цитат DOCX, установку в два шага и примеры запросов агенту. Проект построен на CLI-Anything от HKUDS. Подробные команды лежат в `docs/COMMANDS.md`, планы в `docs/ROADMAP.md`.