AI Agent Translator

🌐 Web Translator AI Agent

—— 基于 Gemini CLI 与 Playwright MCP 的网页内容翻译系统

项目简介

本项目旨在开发一个自动化 AI Agent，可通过输入网页链接自动抓取网页正文并生成 中英文双语版本 的内容文件。 系统提供两种实现路径：

1. Gemini CLI 模式 —— 轻量级命令行方案，适合快速部署与批量翻译；
2. Playwright + MCP 模式 —— 支持动态网页与结构复杂页面的内容提取。

快速开始

1. 克隆项目：

   git clone https://github.com/shige12/ai-agent-translator.git
   cd ai-agent-translator

1. 创建虚拟环境并安装依赖：

   python -m venv venv
   source venv/bin/activate  # 或 Windows: venv\Scripts\activate
   pip install -r requirements.txt
   playwright install chromium

1. 配置 API keys：复制 .env.example 为 .env 并填写变量。
2. 运行示例（Playwright）：

   python -m translator.playwright_agent --url "https://pmc.ncbi.nlm.nih.gov/articles/PMC11749429/"

1. 运行 Gemini CLI 工作流（示例）：

   bash examples/run_gemini_example.sh "https://pmc.ncbi.nlm.nih.gov/articles/PMC11749429/"

目录结构

ai-agent-translator/
├── README.md
├── requirements.txt
├── .env.example
├── LICENSE
├── translator/
│   ├── __init__.py
│   ├── config.py
│   ├── utils.py
│   ├── gemini_agent.py
│   └── playwright_agent.py
├── examples/
│   ├── demo_links.txt
│   └── run_gemini_example.sh
└── output/
    └── demo_output.md

文件说明

• translator/gemini_agent.py：基于 Gemini CLI 的实现（通过 subprocess 调用）。
• translator/playwright_agent.py：基于 Playwright + MCP 的实现，适合动态网页抓取。
• translator/utils.py：文本清洗与文件写入工具。
• .env.example：环境变量示例（API keys、默认语言等）。
• examples/run_gemini_example.sh：一键运行 Gemini CLI 示例脚本。

扩展建议

• 增加并行批处理
• 加入自动摘要/关键词提取模块
• 支持更多输出格式（DOCX、HTML、公众号模板）

许可证

MIT License