中文 | English

R18+ 成人內容 — 本專案索引 FANZA 成人影片資料，使用者須年滿 18 歲並遵守當地法律。

從 FANZA 免費 GraphQL API 查詢 AV 新片、排行榜、女優追蹤、搜尋，自動推送到 Discord / Telegram。

git clone https://github.com/zxcnny930/avbuzz.git
cd avbuzz
npm install
cp config.example.json config.json  # 填入你的 token
npm start

{
  "discord": {
    "token": "YOUR_DISCORD_BOT_TOKEN",
    "guildId": "YOUR_GUILD_ID",
    "channelId": "YOUR_CHANNEL_ID"
  },
  "telegram": {
    "botToken": "YOUR_TELEGRAM_BOT_TOKEN",
    "chatId": "YOUR_CHAT_ID"
  },
  "schedule": {
    "dailyPushHourJST": 0,
    "dailyPushMinuteJST": 5,
    "actressCheckIntervalHours": 6
  }
}

Telegram 欄位留空即可只用 Discord。

1. 到 discord.com/developers → 建立 App → Bot → 複製 Token
2. OAuth2 → URL Generator → scopes: bot → permissions: Send Messages, Embed Links → 邀請 Bot
3. 右鍵伺服器 → 複製伺服器 ID（需開啟開發者模式）
4. 右鍵頻道 → 複製頻道 ID

scp -r . root@your-vps:/root/avbuzz/
ssh root@your-vps
cd /root/avbuzz && npm install
cp config.example.json config.json && nano config.json
cp avbuzz.service /etc/systemd/system/
systemctl daemon-reload && systemctl enable avbuzz && systemctl start avbuzz
journalctl -u avbuzz -f  # 查看日誌

AVBUZZ 也可以作為 ClawHub 技能，讓 AI 直接用 curl 查詢 FANZA 資料，不需要 Discord Bot。

npx clawhub install avbuzz

• 資料來源: FANZA 隱藏 GraphQL API (POST https://api.video.dmm.co.jp/graphql)，免費、無需認證
• Stack: Node.js ES modules, discord.js v14, native fetch
• 持久化: JSON 檔案（data/ 目錄）
• 排程: 自製 setInterval + JST 時區判斷

注意: FANZA GraphQL API 為非官方逆向工程端點，可能隨時變更或停止服務。本專案與 DMM / FANZA 無任何關聯。

雙重授權 — 非商業使用免費（PolyForm Noncommercial 1.0.0）。商業使用需另行取得授權。

R18+ Adult Content — This project indexes adult video content from FANZA. Users must be 18+ and comply with local laws.

Query AV new releases, rankings, actress tracking, and search from FANZA's free GraphQL API. Auto-push to Discord / Telegram.

git clone https://github.com/zxcnny930/avbuzz.git
cd avbuzz
npm install
cp config.example.json config.json  # Fill in your tokens
npm start

{
  "discord": {
    "token": "YOUR_DISCORD_BOT_TOKEN",
    "guildId": "YOUR_GUILD_ID",
    "channelId": "YOUR_CHANNEL_ID"
  },
  "telegram": {
    "botToken": "YOUR_TELEGRAM_BOT_TOKEN",
    "chatId": "YOUR_CHAT_ID"
  },
  "schedule": {
    "dailyPushHourJST": 0,
    "dailyPushMinuteJST": 5,
    "actressCheckIntervalHours": 6
  }
}

Leave Telegram fields empty to run Discord-only.

1. Go to discord.com/developers → Create App → Bot → Copy Token
2. OAuth2 → URL Generator → scopes: bot → permissions: Send Messages, Embed Links → Invite bot
3. Right-click server → Copy Server ID (enable Developer Mode first)
4. Right-click channel → Copy Channel ID

scp -r . root@your-vps:/root/avbuzz/
ssh root@your-vps
cd /root/avbuzz && npm install
cp config.example.json config.json && nano config.json
cp avbuzz.service /etc/systemd/system/
systemctl daemon-reload && systemctl enable avbuzz && systemctl start avbuzz
journalctl -u avbuzz -f  # View logs

AVBUZZ is also available as a ClawHub skill, allowing AI to query FANZA data directly via curl — no Discord bot needed.

npx clawhub install avbuzz

• Data Source: FANZA hidden GraphQL API (POST https://api.video.dmm.co.jp/graphql) — free, no auth
• Stack: Node.js ES modules, discord.js v14, native fetch
• Persistence: JSON files (data/ directory)
• Scheduler: Custom setInterval + JST timezone logic

Note: The FANZA GraphQL API is an unofficial reverse-engineered endpoint and may change or become unavailable at any time. This project is not affiliated with DMM or FANZA.

Dual License — Free for non-commercial use under PolyForm Noncommercial 1.0.0. Commercial use requires a separate license from the author.