Skip to content

Pixiv bot

一個 Telegram 機器人,可以幫助您在 Telegram 發送來自 Pixiv 的作品。

點我開始體驗 | 把 bot 添加至群組

快速入門

普通消息模式

message mode

當匹配到以下連結後 bot 會回覆您:

  • pixiv.net/artworks/:id
  • pixiv.net/artworks/en/:id
  • pixiv.net/i/:id
  • pixiv.net/member_illust.php?illust_id=:id
  • pixiv.net/member_illust.php?illust_id=:id#manga
  • :id (純數字)

支持一個消息裡包含多個連結,一次性全部發送給 bot 就行!

inline 模式

bot 支持 Telegram inline 用法,可在不切換到聊天頁面的時候使用 bot 發送作品。

點擊 share 按鈕或者在聊天窗口 @pixiv_bot

您並不需要開頭大寫 P,只需要 @pixiv_bot 即可,使用者名稱是大小寫不敏感的。

inline mode

此外,inline 模式目前有以下需要切換到普通消息模式的情況:

  • 作品內包含多張圖(多 P)
  • 使用 +spoiler 屬性
  • 動圖(ugoira)尚未被轉檔

需要切換到普通模式的時候會有和圖片一樣的提示:
inline pm alert
請按需求點擊切換到普通消息模式或者直接使用 inline 的結果。

此外,搜索功能暫未實現(需要 Pixiv Premium),因此擱置

進階用法

機器人支持一些自訂配置,下面是配置說明。

自訂配置十分簡單,您只需要在發送作品連結的同時輸入一些關鍵字: 例如 +tags,那麼輸出的作品格式將會帶上標籤。不想要 open 按鈕的時候,輸入 -open 按鈕就消失了:
demo

/s 持久化保存配置

對於一些參數,比如說 +tags 您可能有持久化保存的需求,同樣和上面一樣非常簡單。 例如:

/s +tags -share

在提示成功保存後,默認機器人就會以 +tags -share 的配置來輸出作品。

此功能在群組也適用,並且有調整優先度的選項來讓群裡的格式統一,具體配置參考下個章節。

+overwrite 在群組使用群組設置而非個人設定

您在群組/頻道中想讓群內的成員都使用統一格式的話,可以使用

/s +overwrite

來讓所有群成員都使用群組內配置

如果單次在群組內想輸出自己格式的消息,那麼每次發送的時候帶上 +god 即可

+god 並沒有持久化配置,請在每次使用時加上

自訂消息格式

TODO (參考配置頁面)

cheatsheet

namealiasdescriptionremark
-+tagtags顯示作品標籤作品標籤在遇到一些特殊字元時(例如《》() - ・),不會被識別為可點擊的連結
-+descdescription顯示作品描述
+-idshow_id顯示作品 ID默認顯示格式中沒有%id%欄位,請通過自訂模板實現
-+rm只顯示圖片不顯示按鈕和說明文字(caption)
+-kbkeyboard
remove_keyboard
是否顯示按鈕
+-cpremove_caption是否顯示說明文字
+-open是否顯示打開按鈕
+-share是否顯示分享按鈕在 inline 切換時會被強制啟用
在 channel 中會被強制禁用
-+scsingle_caption發送多張圖片時只顯示一個說明文字無法在 inline 模式使用
-+abovecaption_above將說明文字顯示在圖片上方
-+reverse倒序發送作品不會改變作品內分p的順序
-+fileasfile以文件形式發送無法在 inline 模式使用
-+afappend_file在發送作品的基礎上再發送圖片無法在 inline 模式使用
-+graphtelegraph解析成 Telegraph無法在 inline 模式使用
+-album是否以 MediaGroup 形式發送作品無法在 inline 模式使用
-+onealbum_one是否以 MediaGroup 形式發送所有作品例如您發送了 2 個作品,bot 會將它們作為一個 MediaGroup 一起發送,而不是分開發送
-+equalalbum_equal嘗試以均分方式發送 MediaGroup 作品例如需要發送 14 張圖片時,系統會將其拆分成 7+7,而不是 10+4
-+spspoiler將圖片標記為隱藏(敏感)內容無法在 inline 模式使用
-+captioncaption_extraction解析圖片說明文字並發送關聯作品特殊需求,默認情況下不需要
+-overwrite在群組或頻道中覆蓋用戶的自訂設置無法在 inline 模式使用
使用 inline 模式在群裡發圖也不會觸發覆蓋行為(機器人無法知道用戶當前的群組是什麼)
+god在使用 +overwrite 的群組或者頻道中使用自己的格式無法在 inline 模式使用
不能使用 /s +god 持久化

+album 媒體組系列

bot 支持將多 p 作品合併到一個媒體組中。媒體組(MediaGroup)是 Telegram 的一個功能,可以在一個消息裡顯示多張媒體。

因此 +album 參數預設啟用,此參數作用為單個作品中如果有差分(分 P)的情況,則將所有圖片塞在一個媒體組中。
此外 Telegram 限制 1 個媒體組中最多有 10 張圖,因此在圖片很多的情況下依舊會分開發送,只不過都是以媒體組的情況。
在超過 20 張圖片以上的情況,建議使用下文的 +graph 參數將作品轉換為 Telegram 以供即時預覽。

百聞不如一見,點我查看示範來了解媒體組系列參數的具體作用

+one

如果有多個作品則會將所有作品都合併到一個媒體組裡面。

+equal

當 bot 一次發送超過 10 張圖的時候會嘗試均衡 mediagroup 裡面的數量,比如說有 16 張圖片,會分 2 次每次發送 8 張

+sc

在媒體組裡顯示說明文(caption)
此功能在您需要直接看到當前發了什麼,其中輸出格式為僅顯示作品名稱以及 P 數的格式,您仍然可以自訂此格式。

+graph +telegraph 將作品轉換為 telegraph 頁面

在消息中輸入 +graph / +telegraph 機器人就會將多個作品集成到一個 telegraph 中。
並且返回一個 telegraph 連結,手機可以快速預覽。

此部分為 Telegram Instant View 服務,可能有抓取失敗情況,建議一次低於 200 張。

此部分使用了 webp 轉換伺服器,直接訪問 telegra.ph 頁面可能會收集您的 IP ,更多詳情請參考我們的隱私政策。

telegraph 連結中自訂標題、作者名字以及作者連結

例如:

https://www.pixiv.net/artworks/91105889 +telegraph
title=白スクのやつ
author_name=syokuyou-mogura
author_url=https://www.pixiv.net/users/579672

格式,=號後面的內容全部都會被匹配到,以換行作為分割

telegraph custom

作品版權

本頁面素材來源為:

希望哪一天有預算以及機會可以去和歌山市旅遊
(⁠ノ゚⁠0゚⁠)⁠ノ⁠~