pixiv-cli
Неофициальный CLI и MCP-сервер Pixiv: поиск работ, обратный поиск картинки, закладки и скачивание из терминала или агента.
- 132 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Закладки, подписки и комментарии выполняются от имени вашего аккаунта Pixiv.
- Токены обновления лежат открытым текстом, а удаленный HTTP-режим MCP читает файлы и сеть сервера.
Установка
- Работает в
Ручная установка
brew install FlanChanXwO/tap/pixiv-cliРекомендуемый путь для macOS и Linux; обновление: `brew update && brew upgrade pixiv-cli`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Закладки, подписки и комментарии выполняются от имени вашего аккаунта Pixiv.
- Токены обновления лежат открытым текстом, а удаленный HTTP-режим MCP читает файлы и сеть сервера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pixiv-cli — неофициальный клиент Pixiv на Go. Команда `pixiv` ищет иллюстрации, романы и авторов с фильтрами по рейтингу, режиму ИИ, разрешению и числу закладок, показывает все 16 режимов рейтинга, рекомендации и ленты, а по картинке ищет источник через SauceNAO и ascii2d. Закладки, подписки, комментарии и скачивание (диапазоны страниц, Ugoira в GIF или APNG) выполняются от имени залогиненного аккаунта. Команда `pixiv mcp` поднимает MCP-сервер с теми же возможностями: локальный по stdio и удаленный по HTTP с OAuth. В репозитории лежит скилл `skills/pixiv-cli` для агента с проверкой версии, правилами обращения с токенами и подтверждением изменений. Pixiv Fanbox читается только на чтение, через отдельный `FANBOXSESSID`.
Для кого. Тем, кто собирает подборки референсов и коллекции на Pixiv и хочет автоматизировать поиск и скачивание из терминала, скриптов или агента.
Подходит, если
- Иллюстрации по тегу нужны без работ ИИ и в высоком разрешении.
- Есть картинка без подписи, и по ней ищут автора через SauceNAO или ascii2d.
- Все работы одного автора скачивают в папку пакетом, с отчетом об ошибках.
- Агент собирает ленту дневного рейтинга и отправляет выбранное в закладки.
Не подходит, если
- Нужен официальный клиент: проект не связан с Pixiv Inc.
- Работа идет без аккаунта Pixiv: API приложения принимает только авторизованные запросы.
- Скачивание нарушит условия Pixiv или права авторов.
Пример запроса к агенту
Найди на Pixiv иллюстрации по тегу «初音ミク» без работ ИИ в высоком разрешении и покажи первые пять.Ограничения
Нужен аккаунт Pixiv и вход через браузерный OAuth (`pixiv auth login`). Проект неофициальный, README просит соблюдать условия Pixiv и закон. Удаленный HTTP-режим MCP действует на файлы и сеть сервера, например обратный поиск читает пути на сервере, поэтому доступ дают только доверенным клиентам. Токены обновления и пакеты экспорта лежат открытым текстом и не должны попадать в чат или логи. Скилл для агента ставят вручную: каталог `skills/pixiv-cli` берут из тега, совпадающего с версией CLI. Для Fanbox отдельно нужен `FANBOXSESSID`.
Как отключить. Удалите сервер `pixiv` из конфигурации MCP-клиента и сам бинарный файл (для Homebrew `brew uninstall pixiv-cli`). Сохраненные аккаунты уберите командой `pixiv auth remove`.
Частые вопросы
Как подключить pixiv-cli к MCP-клиенту?
Добавьте в конфигурацию клиента сервер `pixiv` с командой `pixiv` и аргументом `mcp`. Режим по умолчанию — stdio, он использует аккаунты, уже сохраненные CLI.
Как запустить MCP по HTTP?
Один раз выполните `pixiv mcp auth init`, затем `pixiv mcp --port 1270`: сервер ответит по адресу `http://127.0.0.1:1270/mcp`. За HTTPS-прокси добавьте `--base-url`.
Как поставить без Homebrew?
Есть скрипт `install.sh` для Linux и macOS, `install.cmd` для Windows, образ Docker `ghcr.io/flanchanxwo/pixiv-cli` и `go install`. Скрипты проверяют SHA-256 релиза, но перед запуском их лучше прочитать.
Можно ли скачать все работы автора?
Да: передайте `pixiv download` ссылку вида `https://www.pixiv.net/users/12345678/artworks`. Для диапазона страниц одной работы есть параметр `--pages`.
Чем скилл отличается от самого CLI?
CLI выполняет команды Pixiv. Скилл `skills/pixiv-cli` учит агента проверять версию, не раскрывать токены и подтверждать изменения аккаунта перед закладками, подписками и скачиванием.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер дает агенту 123 инструмента Aseprite для пиксель-арта и анимации и снимки, по которым он проверяет рисунок
Скилл, MCP-сервер и CLI: любой агент вызывает встроенную генерацию картинок Codex, выбрав стиль из нескольких направлений
Pixelbolt дает агенту рисовать и править пиксель-арт по JSON-рецепту: спрайты, тайлы, эффекты и анимации в PNG, GIF и атласы.
Скиллы для агента, который через CLI PixVerse делает видео, картинки, озвучку и музыку по готовым конвейерам.
MCP-сервер Gyazo: агент ищет скриншоты по ключевому слову или приложению, читает текст на снимках через OCR и загружает новые
Удаленный MCP-сервер Recraft: агент рисует растровые и векторные изображения, редактирует область, убирает фон и увеличивает разрешение
Коротко о README
README показывает каналы установки (Homebrew, скрипты, Docker, Go), быстрый старт на минуту, выбор между CLI и MCP, схему конвейера с NDJSON и ссылки на документацию. Отдельный блок содержит промпт, по которому агент ставит CLI и скилл.