Pixiv-App-API 速览：三行代码获取 Node.js Pixiv 数据的 Promise 封装 Pixiv API 客户端

Pixiv-App-API 速览三行代码获取 Node.js Pixiv 数据的 Promise 封装 Pixiv API 客户端【免费下载链接】pixiv-app-apiPromise base pixiv API client项目地址: https://gitcode.com/gh_mirrors/pi/pixiv-app-apiPixiv-App-API 是一个面向 Node.js 的 Promise 封装 Pixiv API 客户端装好即可搜索作品、拉取排行榜与热门标签部分接口免登录即可调用几分钟内就能搭出自己的 Pixiv 数据管道。场景切入你正在做一个个人小站想在首页展示当天 Pixiv 热门作品前十翻了一圈官方文档却发现请求参数、返回字段全是坑又或者你想写个脚本盯住某个标签的热度变化又怕连续翻页把账号请求得过于频繁。这些是 Node.js 项目获取 Pixiv 数据时最常见的两个卡点而 Pixiv-App-API 就是冲着这些问题来的。它是什么Pixiv-App-API 是一个基于 Promise 的 Pixiv API 客户端接口设计灵感来自 Python 生态的老牌库 pixivpy覆盖了 app-api 常用端点。在此基础上它针对 Node.js 与 TypeScript 环境做了进一步的工程化处理方法全部返回 Promise响应键值自动转换命名风格并附带完整的类型定义——可以理解为给 TS 开发者准备的 pixivpy。核心能力免登录获取 Pixiv 公共数据部分接口不需要账号凭据即可调用。比如illustRecommendedNologin、novelRecommendedNologin可以在未登录状态下直接拿到推荐插画与小说数据。如果你的需求只是公共内容——小站上的「今日热门」模块、标签热度监控——完全可以不配置用户名和密码装完就能出数据上手成本很低。返回键值自动驼峰转换默认情况下camelcaseKeys: true接口返回 JSON 里的totalView、createDate这类 snake_case 字段会被自动转成 camelCase调用参数则反向自动转为 snake_case。如果你的代码风格习惯下划线命名把这个选项设为false即可。省掉的是业务代码里手工拼字段名的琐碎工作。完整的 TypeScript 类型定义项目本身用 TypeScript 编写随包发布类型声明并按camelcaseKeys的开与关提供两套对应类型PixivTypes与Pixiv_Types。写 TS 项目时访问json.illusts[0].imageUrls.large这样的路径有自动补全和结构提示字段拼错在编译期就能发现这是直接 fetch 裸接口拿不到的体验。流式处理避免限流makeIterable把一个搜索响应包装成 AsyncIterable配合hasNext()/next()逐页推进。在for await循环里你可以自行控制翻页间隔官方示例建议每页之间 sleep 1 秒。相比一次性把所有页拉完这种节奏可预测的请求方式能明显降低 Pixiv 侧的限流风险适合批量抓取作品列表的场景。五分钟上手先安装npm install --save pixiv-app-api然后初始化并发起第一次请求const Pixiv require(pixiv-app-api) const pixiv new Pixiv(process.env.NAME, process.env.PASSWORD, { camelcaseKeys: true }) const json await pixiv.illustRecommended()两个关键配置点camelcaseKeys默认true想保留原始 snake_case 键值时传false同时使用对应的 snake_case 类型构造函数的用户名、密码参数均为可选只调免登录接口时可以不传。完整的接口列表与参数说明PixivParams支持排序、时间范围、R18 过滤等可在项目根目录的 readme.md 中查到。适合谁用适合三类人想把 Pixiv 公共数据快速嵌入个人站点、博客或小工具的开发者希望有类型提示、不想手写请求层的 TS/JS 开发者需要逐页抓取作品列表、又希望把请求节奏掌握在自己手里的脚本作者。反过来如果你的团队完全在 Python 生态内直接参考 pixivpy 的社区资料可能更顺手此外它本质是一层轻量封装不带代理池、重试机制等配套设施若要做大规模采集服务限流与容错层仍需自行实现。写在最后如果你的目标只是「稳定地拿到 Pixiv 数据」而不是重新发明请求层装上试试一条 npm 命令三行代码第一页数据就会出现在控制台里。【免费下载链接】pixiv-app-apiPromise base pixiv API client项目地址: https://gitcode.com/gh_mirrors/pi/pixiv-app-api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考