pixiv client for go

Pixiv go 客户端， 使用 PIXIV 网页 API。

设计文档

• 画作搜索
• 画作排行榜
• 画作详情
• 小说搜索
• 小说排行榜
• 小说详情
• 渲染小说为 HTML
• 用户详情

详细使用方法以代码注释为准

2024-08-27: 账号密码登录方式已失效，手动登录获取 PHPSESSID 代替

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 数据。