🎨 一个用于搜索 aitag.win AI绘画作品的Telegram机器人

• 🔍 关键词搜索：通过关键词搜索AI绘画作品
• 📄 分页浏览：支持上一页/下一页按钮浏览更多结果
• 🌐 多语言支持：支持中文和英文关键词
• 🐳 Docker部署：使用Docker Compose一键部署

• Docker 和 Docker Compose
• Telegram Bot Token（通过 @BotFather 创建）

1. 在服务器上创建项目目录

mkdir aitag-search-bot
cd aitag-search-bot

2. 创建 docker-compose.yml 文件

cat > docker-compose.yml << 'EOF'
version: '3.8'

services:
  telegram-bot:
    image: ghcr.io/arturia169/aitag-search-bot:main
    container_name: aitag-search-bot
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - TZ=Asia/Shanghai
    pull_policy: always
EOF

3. 创建 .env 配置文件

cat > .env << 'EOF'
# Telegram Bot Configuration
TELEGRAM_BOT_TOKEN=your_bot_token_here

# Website Configuration
BASE_URL=https://aitag.win
RESULTS_PER_PAGE=5

# API Configuration
API_TIMEOUT=30
EOF

4. 编辑 .env 文件，填入你的Bot Token

nano .env  # 或使用 vi .env
# 将 your_bot_token_here 替换为实际的Token

5. 拉取镜像并启动

docker-compose pull
docker-compose up -d

1. 克隆仓库

git clone https://github.com/Arturia169/aitag-search-bot.git
cd aitag-search-bot

2. 配置环境变量

cp .env.example .env

编辑 .env 文件，填入你的Bot Token：

TELEGRAM_BOT_TOKEN=your_bot_token_here

3. 启动机器人

docker-compose up -d

4. 查看日志

docker-compose logs -f

5. 停止机器人

docker-compose down

• /start - 显示欢迎信息和使用说明
• /search <关键词> - 搜索AI绘画作品
• /help - 显示帮助信息

1. 使用命令搜索

/search wuwa
/search genshin impact
/search 原神

2. 直接发送关键词

wuwa
原神

3. 浏览结果
   • 使用消息下方的"上一页"/"下一页"按钮浏览更多结果

在 .env 文件中可以配置以下选项：

如果您的服务器需要通过代理访问Telegram API，可以配置 PROXY_URL：

# HTTP代理
PROXY_URL=http://proxy.example.com:8080

# SOCKS5代理
PROXY_URL=socks5://proxy.example.com:1080

# 带认证的代理
PROXY_URL=http://username:password@proxy.example.com:8080

aitag-search-bot/
├── bot/
│   ├── __init__.py          # 包初始化
│   ├── main.py              # 主程序入口
│   ├── config.py            # 配置管理
│   ├── api_client.py        # API客户端
│   └── telegram_bot.py      # Telegram机器人逻辑
├── Dockerfile               # Docker镜像配置
├── docker-compose.yml       # Docker Compose配置
├── requirements.txt         # Python依赖
├── .env.example            # 环境变量示例
└── README.md               # 项目说明

• Python 3.11+
• python-telegram-bot - Telegram Bot API封装
• aiohttp - 异步HTTP客户端
• Docker - 容器化部署

1. 安装依赖

pip install -r requirements.txt

2. 设置环境变量

export TELEGRAM_BOT_TOKEN=your_bot_token_here

3. 运行机器人

python -m bot.main

1. 在Telegram中找到 @BotFather
2. 发送 /newbot 创建新机器人
3. 按照提示设置机器人名称和用户名
4. 复制获得的Token到 .env 文件

1. 检查Docker容器是否正常运行：docker-compose ps
2. 查看日志：docker-compose logs -f
3. 确认Bot Token是否正确配置

如果看到 Timed out 或网络连接错误，可能是以下原因：

1. 需要代理访问Telegram

   # 在 .env 文件中添加代理配置
   PROXY_URL=http://your-proxy:port
   # 或
   PROXY_URL=socks5://your-proxy:port

2. 增加超时时间

   # 在 .env 文件中增加超时设置
   CONNECTION_TIMEOUT=60
   READ_TIMEOUT=60

3. 检查网络连接

   # 测试是否能访问Telegram API
   curl -I https://api.telegram.org

4. 重启容器

   docker-compose restart

1. 尝试使用不同的关键词
2. 检查网络连接是否正常
3. 确认 aitag.win 网站是否可访问

MIT License

本项目数据来源于 aitag.win，一个AI绘画咒语图库。

欢迎提交Issue和Pull Request！

• GitHub: @Arturia169