pixiv-cli: Akses Pixiv berbasis Go untuk alur kerja terminal dan agen AI
pixiv-cli, yang dikembangkan oleh FlanChanXwO, adalah toolkit berbasis Go yang mengekspos fungsionalitas Pixiv ke terminal dan ke agen AI yang mendukung MCP. Ini beroperasi baik sebagai aplikasi baris perintah maupun sebagai server Model Context Protocol, menawarkan pencarian, pengambilan metadata karya seni, akses peringkat, dan manajemen unduhan untuk gambar tunggal, manga multi-halaman, dan koleksi. Alat ini mengelola otentikasi OAuth 2.0 PKCE dengan token penyegaran, menyediakan fallback anonim, dan mencakup SDK Go, menjadikannya cocok untuk pengembang, pengguna Pixiv yang berpengalaman, dan programmer Go yang bekerja dengan alur kerja AI.
Anda dapat mengotomatiskan pencarian Pixiv, pengambilan metadata, dan unduhan dari shell
Alat ini berfungsi sebagai klien Pixiv yang berfokus pada shell, memungkinkan pengguna menjalankan pencarian, memeriksa detail karya seni, dan mengambil set gambar lengkap dari skrip atau shell interaktif. Perintah CLI utama mencakup pixiv search, pixiv detail, pixiv ranking, dan pixiv download. Set perintah tersebut mendukung gambar tunggal, manga multi-halaman, dan koleksi, sehingga skrip otomatisasi dapat menyusun dan menyimpan aset yang dikelompokkan tanpa klien grafis.
Mode MCP menyediakan data Pixiv terstruktur yang disesuaikan untuk konsumsi agen
Ketika dijalankan sebagai server Model Context Protocol, alat ini menyediakan metadata terstruktur dan daftar daripada hanya file gambar, yang cocok untuk pemrosesan hilir oleh model bahasa dan agen. Ini mengambil metadata karya seni, umpan peringkat, dan entri rekomendasi pribadi saat terautentikasi, mengembalikan bentuk data yang dapat diprediksi dari sisi server sehingga integrasi mengkonsumsi keluaran mirip JSON daripada hasil pengambilan halaman mentah.
Memulai memerlukan pengetahuan tentang baris perintah dan klien MCP untuk fitur agen
Pengaturan mengharapkan familiaritas dengan alur kerja terminal dan langkah-langkah konfigurasi dasar. Distribusi ini menyediakan biner Go lintas platform untuk Windows, macOS, dan Linux, ditambah SDK Go untuk menyematkan panggilan ke dalam proyek. Penanganan akun menggunakan OAuth 2.0 PKCE dengan manajemen token penyegaran dan mendukung beberapa akun terautentikasi, yang membantu saat beralih profil dalam lingkungan skrip atau CI.
Autentikasi dan fallback anonim menentukan konten apa yang dapat Anda akses
Akses fitur tergantung pada autentikasi: profil yang masuk memperlihatkan bookmark dan rekomendasi, sementara fallback anonim mengizinkan pencarian dan unduhan publik. Penyegaran token ditangani oleh alat untuk mengurangi login ulang secara manual. Untuk penjelajahan agen AI, klien yang sesuai dengan MCP (misalnya, klien desktop yang disebutkan) harus terhubung ke server MCP sehingga agen dapat meminta dan menerima data Pixiv; tanpa klien tersebut alur kerja yang menghadapi agen tidak dapat dijalankan.
Pilihan praktis, berbasis kode untuk pengembang dan alur kerja berbasis terminal
Alat ini cocok untuk pengembang yang menerima alur kerja baris perintah dan ingin akses Pixiv secara programatik untuk otomatisasi atau saluran AI. Harapkan fase pengaturan awal dan kurva pembelajaran yang sederhana sebelum otomatisasi skala besar. Tip praktis: validasi beberapa kueri sampel dan keluaran yang disimpan dalam folder yang terkendali sebelum menjalankan unduhan batch atau mengintegrasikan hasil ke dalam sistem lain. Pendekatan ini mengurangi kesalahan saat memberi hasil kepada model.
