网页翻译AI代理

一个自动化AI代理,可通过输入网页链接自动抓取网页正文并生成中英文双语版本的内容文件,支持命令行和动态网页抓取两种模式。

  • by shige12
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 shige12/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
    
  2. 创建虚拟环境并安装依赖:
    python -m venv venv
    source venv/bin/activate  # 或 Windows: venv\Scripts\activate
    pip install -r requirements.txt
    playwright install chromium
    
  3. 配置 API keys:复制 .env.example 为 .env 并填写变量。
  4. 运行示例(Playwright):
    python -m translator.playwright_agent --url "https://pmc.ncbi.nlm.nih.gov/articles/PMC11749429/"
    
  5. 运行 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