MCPcopy Index your code
hub / github.com/Dituon/pixiv-api-http

github.com/Dituon/pixiv-api-http @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
23 symbols 69 edges 26 files 0 documented · 0% updated 9mo ago★ 38
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

pixiv-api-http

[!IMPORTANT]
请使用 Node LTS 版本 (例如 18.20.0), 经测试 Node 20+ 存在LTS代理问题

Intro

此API旨在为 Pixiv 开发者提供终极解决方案

可直接访问 Pixiv, 绕过防火墙封锁 (如 天朝 伊朗 等)

工作原理

支持 GET POST WebSocket 协议

可选:

  • 绕过政府防火墙封锁
  • 使用图床原始IP地址
  • 非会员搜索优化
  • 本地图片反向代理

API

(可混用 POST GET 请求)

Config

配置文件 config.js

proxy

代理设置

应用服务器 (www.pixiv.net *.pixiv.net)

  • bypassSNI (boolean): 绕过防火墙的SNI封锁 (如天朝, 韩国, 伊朗等)
  • serverHost (IP[]): 服务器原始IP, 用于绕过DNS欺骗

图片服务器 (i.pximg.net)

  • useOriginIP (boolean): 替换图片链接为图床原始IP, 可在墙内通过原始IP获取图片, 使用http连接加快访问速度
  • useLocalProxy (boolean): 启动代理服务器, 替换图片链接为本机代理, 免去Referer设置
  • imageHost (IP[]): 图片服务器原始IP, 用于绕过DNS欺骗
useOriginIP useLocalProxy 行为
false false 返回原始链接
true false 替换图片链接为原始IP
false true 替换图片链接为本机代理, 启动代理服务器, 代理使用HTTPS访问图床域名
true true 替换图片链接为本机代理, 启动代理服务器, 代理使用HTTP访问图床IP

pixiv

Pixiv设置

  • lang (Lang): 语言设置, 用于小说搜索, API报错等
lang 语言
ja 日本語
en English
zh-cn 简体中文
zh-tw 繁體中文
  • cookie (string): 你的 Cookie (参考 Tips)

  • premium (boolean): 拥有pixiv会员, 填入false启用非会员搜索优化, 参考 工作方式

httpServer

HTTP API 服务器设置

  • port (number): 端口
  • host (string): IP / 域名

websocketServer

WebSocket API 服务器设置

  • port (number): 端口
  • host (string): IP / 域名

Deploy

  1. install node.js
  2. git clone npm i
  3. 浏览器登录 pixiv.net, 获取 cookie (参考 Tips)
  4. 编辑 config.js
  5. npm start

Tips

  • 部分功能设置cookie后可用
  • 获取cookie: 详见 #2
  • 部分功能需要Pixiv会员账户, 非会员搜索优化请参考 工作方式
  • 设置 Headers: Refererhttps://www.pixiv.net/ 即可直接访问图片

TODO

  • manga-series
  • gif
  • user

About

交流群: 781804589

Core symbols most depended-on inside this repo

Shape

Function 23

Languages

TypeScript100%

Modules by API surface

core/api/module/illust/pid.js4 symbols
core/api/module/follow/update-push.js4 symbols
core/api/module/novel/series-pid.js3 symbols
core/pixiv-fetch/fetch.js2 symbols
core/api/module/search/search.js2 symbols
core/api/module/illust/recommend.js2 symbols
core/api/module/follow/follow.js2 symbols
core/pixiv-fetch/agent.js1 symbols
core/api/module/search/no-premium.js1 symbols
core/api/module/novel/pid.js1 symbols
core/api/module/manga/manga-pid.js1 symbols

For agents

$ claude mcp add pixiv-api-http \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page