https://github.com/natescarlet/pixiv
Pixiv go 客户端， 使用 Pixiv 网页 API。
https://github.com/natescarlet/pixiv
client pixiv pixiv-api
Last synced: about 1 year ago
JSON representation
Pixiv go 客户端， 使用 Pixiv 网页 API。
- Host: GitHub
- URL: https://github.com/natescarlet/pixiv
- Owner: NateScarlet
- License: mit
- Created: 2019-11-30T13:20:30.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-04-03T22:26:58.000Z (about 1 year ago)
- Last Synced: 2025-04-05T00:02:23.504Z (about 1 year ago)
- Topics: client, pixiv, pixiv-api
- Language: Go
- Homepage: https://natescarlet.github.io/pixiv/
- Size: 416 KB
- Stars: 34
- Watchers: 1
- Forks: 5
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# pixiv client for go
[](https://pkg.go.dev/github.com/NateScarlet/pixiv/pkg)
[](https://github.com/NateScarlet/pixiv/actions)
Pixiv go 客户端， 使用 PIXIV 网页 API。
[设计文档](https://natescarlet.github.io/pixiv/)
- [x] 画作搜索
- [x] 画作排行榜
- [x] 画作详情
- [x] 小说搜索
- [ ] 小说排行榜
- [x] 小说详情
- [x] 渲染小说为 HTML
- [ ] 用户详情
详细使用方法以代码注释为准
2024-08-27: 账号密码登录方式已失效，手动登录获取 PHPSESSID 代替
```go
package main
import (
"context"
"slices"
"github.com/NateScarlet/pixiv/pkg/client"
"github.com/NateScarlet/pixiv/pkg/artwork"
"github.com/NateScarlet/pixiv/pkg/novel"
"github.com/NateScarlet/pixiv/pkg/user"
)
// 默认客户端用环境变量 `PIXIV_PHPSESSID` 登录。
// 并且 User-Agent 使用 `PIXIV_USER_AGENT` 或库内置的默认值。
client.Default
// 使用 PHPSESSID Cookie 登录 (推荐)。
c := &client.Client{}
c.SetDefaultHeader("User-Agent", client.DefaultUserAgent)
c.SetPHPSESSID("PHPSESSID")
// 启用免代理，环境变量 `PIXIV_BYPASS_SNI_BLOCKING` 不为空时自动为默认客户端启用免代理。
// 当前实现需求一个 DNS over HTTPS 服务，默认使用 cloudflare，可通过 `PIXIV_DNS_QUERY_URL` 环境变量设置。
// 必须在其他客户端选项前调用 `BypassSNIBlocking`，因为对于封锁的域名它会使用一个更改过的 Transport 进行请求，无视在它之前进行的的设置。
c := &client.Client{}
c.BypassSNIBlocking()
c.SetDefaultHeader("User-Agent", client.DefaultUserAgent)
// 所有查询从 context 获取客户端设置, 如未设置将使用默认客户端。
var ctx = context.Background()
ctx = client.With(ctx, c)
// 搜索画作 (默认最新排序)
payload, _ := artwork.SearchV2(ctx, "パチュリー・ノーレッジ")
for item := range payload.Items() {
fmt.Println(item.Title(), "by", item.AuthorName())
}
// 高级搜索 (带过滤选项)
payload, _ := artwork.SearchV2(ctx, "パチュリー・ノーレッジ",
artwork.SearchWithPage(3), // 第3页
artwork.SearchWithContentRating(artwork.R18Content),
artwork.SearchWithMode(artwork.PartialTagSearch)
)
// 获取排行榜
rank, _ := artwork.FetchRank(ctx,
artwork.DailyRank, // 每日榜
artwork.FetchRankWithDate(yesterday), // 指定日期
artwork.FetchRankWithPage(2) // 第二页
)
for item := range rank.Items() {
fmt.Printf("第%d名: %s", item.Position(), item.Title())
}
// 获取画作元数据
art, _ := artwork.Fetch(ctx, "22238487")
fmt.Println("作品描述:", art.Description())
for tag := range art.Tags() {
fmt.Println("标签:", tag)
}
fmt.Println("查看网页版:", art.URL().String())
// 获取画作全部分页
pages, _ := artwork.FetchPages(ctx, "22238487")
for page := range pages.Pages() {
fmt.Println("原图地址:", page.OriginalURL())
}
// 搜索小说
result, err := novel.Search(ctx, "パチュリー・ノーレッジ")
result.JSON // json return data.
result.Novels() // []novel.Novel，只有部分数据，通过 `Fetch` 方法获取完整数据。
novel.Search(ctx, "パチュリー・ノーレッジ", novel.SearchOptionPage(2)) // 获取第二页
// 小说详情
i := &novel.Novel{ID: "11983096"}
err := i.Fetch(ctx) // 获取小说详情, 直接更新 struct 数据。
// 用户详情
i := &user.User{ID: "789096"}
err := i.Fetch(ctx) // 获取用户详情, 直接更新 struct 数据。
```