Claude Arm64 Browser

🚀 面向大众的无代码人工智能软件即服务构建器

本项目借助人工智能的辅助，能让用户在仅价值 80 美元的硬件上构建并测试完整的软件即服务（SaaS）应用程序。这一创新方案旨在为全球预算有限的开发者提供平等的人工智能驱动开发机会。

🚀 快速开始

零基础入门指南

从未设置过树莓派？ 完整设置指南 - 按步骤操作，30 分钟内从零基础成为 SaaS 构建者！

前提条件

# 安装系统依赖
sudo apt update
sudo apt install chromium-browser nodejs npm python3

# 验证 Chromium 是否正常工作
chromium-browser --version

安装

git clone https://github.com/nfodor/claude-arm64-browser
cd claude-arm64-browser
npm install
chmod +x *.py *.sh

快速测试（单行命令）

# 安装后立即验证是否正常工作：
python3 -c "import sys; sys.path.append('.'); import arm64_browser; print('[OK] ARM64 Browser Works!' if 'error' not in arm64_browser.navigate('https://example.com').lower() else '[FAIL] Failed')"

预期结果：[OK] ARM64 Browser Works!

>>> 运行超棒的演示

# 快速演示，立即看到可见结果（30 秒）
python3 instant_demo.py

# 或者进行全面演示，展示所有功能（2 - 3 分钟）
./run_demo.sh

测试设置

# 直接测试 MCP 服务器
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node index.js

# 测试 Python 包装器
python3 simple_browser.py

✨ 主要特性

人工智能开发的革命

• 旧方式：企业级人工智能开发需要价值 5 万美元以上的工作站，这使得全球 95% 的开发者被排除在外。
• 新方式：只需 480 美元的树莓派设置，就能拥有与硅谷初创公司相同的人工智能能力。

变革的意义

• 消除资金障碍：原本需要 5 万美元的成本，现在只需 480 美元（降低了 99%）。
• 全球可及性：在每个国家都能负担得起，而不仅仅是硅谷。
• 无代码革命：人工智能负责构建 SaaS，而你只需专注于客户。
• 完全自动化：从想法到部署应用，无需手动编码。
• 即时测试：人工智能在用户看到之前测试每个功能。

适合全球创客运动

• 国际创业者：以本地预算使用硅谷的人工智能工具。
• 学生和教育工作者：无需负债即可学习现代人工智能开发。
• 副业爱好者：在不影响本职工作的情况下构建 SaaS 产品。
• 独立创始人：一个价值 80 美元的设备就能成为完整的开发团队。
• 小团队：与获得风险投资的初创公司竞争。
• 远程社区：只要有互联网，任何地方都能进行人工智能开发。

无需编码即可构建的内容

切实可行的人工智能驱动的 SaaS 创意

• 电子商务工具：
  • 监控数千个竞争对手的价格。
  • 产品研究和市场分析。
  • 自动库存跟踪。
  • 从评论中进行客户情绪分析。
• 商业智能：
  • 社交媒体监控仪表盘。
  • SEO 排名跟踪服务。
  • 潜在客户生成和资格评估。
  • 竞争对手分析平台。
• 自动化服务：
  • 网站正常运行时间监控。
  • 内容验证和合规性检查。
  • 数据录入和处理。
  • 表单填写和提交服务。
• 营销解决方案：
  • A/B 测试平台。
  • 着陆页优化。
  • 电子邮件营销活动监控。
  • 社交证明收集。

神奇之处：人工智能承担繁重工作

1. 描述你的想法：例如，“我想监控竞争对手的价格”。
2. 人工智能编写代码：Claude 构建抓取逻辑。
3. 人工智能测试一切：自动浏览器测试确保其正常工作。
4. 部署和扩展：你的 SaaS 已准备好面向客户。
5. 盈利：专注于营销，人工智能维护产品。

独特之处

• 无代码 SaaS 开发：
  • 用通俗易懂的英语描述你的应用想法。
  • 人工智能编写、测试和部署你的应用程序。
  • 专注于客户，而非编码。
  • 数天内即可推出，而非数月。
• 大幅降低成本：
  • 480 美元与传统人工智能开发的 5 万美元以上成本相比。
  • 与硅谷初创公司拥有相同的能力。
  • 无需 recurring cloud bills 或许可费用。
  • 拥有自己的开发基础设施。
• 全球可访问性：
  • 只要有互联网连接，任何地方都能使用。
  • 在每个国家和货币体系下都能负担得起。
  • 无需技术背景。
  • 包含完整的教程和示例。
• 即时结果：
  • 实时查看你的 SaaS 运行情况。
  • 人工智能自动测试每个功能。
  • 无需调试或技术故障排除。
  • 当天即可部署给客户。

📦 安装指南

前提条件

# 安装系统依赖
sudo apt update
sudo apt install chromium-browser nodejs npm python3

# 验证 Chromium 是否正常工作
chromium-browser --version

安装步骤

git clone https://github.com/nfodor/claude-arm64-browser
cd claude-arm64-browser
npm install
chmod +x *.py *.sh

💻 使用示例

基础用法

import simple_browser

# 导航到任何网站
result = simple_browser.browser_navigate("https://example.com")
print(result)  # "Successfully navigated to https://example.com"

# 截图
screenshot = simple_browser.browser_screenshot("homepage.png")
print(screenshot)  # "Screenshot saved to /tmp/homepage.png"

# 执行 JavaScript
title = simple_browser.browser_evaluate("document.title")
print(title)  # 网站标题

# 提取页面内容
content = simple_browser.browser_get_content("text")
print(content[:100])  # 页面文本的前 100 个字符

高级用法

端到端 SaaS 测试（改变游戏规则）

# 完整用户旅程测试 - 无需人工调试
def test_saas_signup_flow():
    # 导航到注册页面
    simple_browser.browser_navigate("https://yourapp.com/signup")
    
    # 填写注册表单
    simple_browser.browser_fill("#email", "test@example.com")
    simple_browser.browser_fill("#password", "securepass123")
    simple_browser.browser_click("#signup-btn")
    
    # 验证注册是否成功
    success_msg = simple_browser.browser_evaluate("document.querySelector('.success-message').textContent")
    
    # 测试仪表盘访问
    simple_browser.browser_navigate("https://yourapp.com/dashboard")
    dashboard_loaded = simple_browser.browser_evaluate("document.querySelector('.dashboard').style.display !== 'none'")
    
    # 截图用于视觉回归测试
    simple_browser.browser_screenshot("dashboard_post_signup.png")
    
    return "PASS" if success_msg and dashboard_loaded else "FAIL"

自主 API + 前端测试

# 通过前端验证后端 API
def validate_api_through_ui():
    # 通过 UI 测试数据创建
    simple_browser.browser_navigate("https://yourapp.com/create-project")
    simple_browser.browser_fill("#project-name", "Test Project AI")
    simple_browser.browser_click("#create-btn")
    
    # 验证数据是否出现在列表视图中
    simple_browser.browser_navigate("https://yourapp.com/projects")
    project_exists = simple_browser.browser_evaluate("document.querySelector('[data-project=\"Test Project AI\"]') !== null")
    
    # 测试数据修改
    simple_browser.browser_click("[data-project=\"Test Project AI\"] .edit-btn")
    simple_browser.browser_fill("#project-name", "Modified by AI")
    simple_browser.browser_click("#save-btn")
    
    # 验证后端数据持久化
    simple_browser.browser_navigate("https://yourapp.com/projects")
    updated = simple_browser.browser_evaluate("document.querySelector('[data-project=\"Modified by AI\"]') !== null")
    
    return {"api_create": project_exists, "api_update": updated}

跨浏览器兼容性测试（无需人工干预）

# 自动化跨平台测试
def test_responsive_design():
    test_results = {}
    
    # 移动视图端口
    simple_browser.browser_evaluate("window.resizeTo(375, 667)")  # iPhone 尺寸
    simple_browser.browser_navigate("https://yourapp.com")
    simple_browser.browser_screenshot("mobile_view.png")
    mobile_nav = simple_browser.browser_evaluate("document.querySelector('.mobile-nav').style.display !== 'none'")
    
    # 桌面视图端口  
    simple_browser.browser_evaluate("window.resizeTo(1920, 1080)")
    simple_browser.browser_screenshot("desktop_view.png")
    desktop_nav = simple_browser.browser_evaluate("document.querySelector('.desktop-nav').style.display !== 'none'")
    
    return {"mobile_responsive": mobile_nav, "desktop_responsive": desktop_nav}

竞争分析自动化

# 监控竞争对手的价格
simple_browser.browser_navigate("https://competitor.com/pricing")
simple_browser.browser_screenshot("competitor_pricing.png")
prices = simple_browser.browser_evaluate("document.querySelectorAll('.price').length")

SEO 监控

# 检查搜索排名
simple_browser.browser_navigate("https://google.com/search?q=your+keywords")
simple_browser.browser_screenshot("serp_results.png")
rankings = simple_browser.browser_evaluate("document.querySelector('.g').textContent")

📚 详细文档

为什么 ARM64 + 浏览器自动化是 SaaS 的黄金组合

SaaS 开发的关键差距

每个 SaaS 初创公司在发布应用程序之前都必须确保其端到端正常工作。传统方法存在以下问题：

• 手动测试：昂贵、缓慢、容易出错且无法扩展。
• 仅支持 x86_64 的工具：Puppeteer/Playwright 在 ARM64 上因二进制文件损坏而失败。
• 人工调试：QA 团队需要花费数天时间调试测试失败的问题。
• 覆盖范围有限：没有庞大的团队就无法测试每个用户旅程。
• 回归盲点：更改会在未被检测到的情况下破坏现有功能。

我们的突破：ARM64 上的自主人工智能测试

• 无需人工调试：人工智能代理自动测试完整的用户流程。
• 24/7 持续测试：在预算有限的硬件上进行持续验证。
• 全栈覆盖：通过真实浏览器验证前端、后端和 API。
• 视觉回归检测：截图自动捕捉 UI 破坏更改。
• 跨设备测试：移动/平板/桌面视图端口自动化。
• 原生 ARM64：使用系统 Chromium 而不是损坏的 x86_64 二进制文件。
• 成本效益高：480 美元的设置与传统 QA 基础设施的 5 万美元以上成本相比。

为什么这将永远改变 SaaS 开发

• 之前：手动 QA 团队 → 昂贵 → 缓慢 → 人为错误 → 覆盖范围有限

部署 → 祈祷 → 客户发现漏洞 → 紧急修复 → 声誉受损

• 之后：人工智能代理 → 自主 → 快速 → 全面 → 24/7 监控

编写代码 → 人工智能测试一切 → 自信地部署 → 满意的客户

ARM64 的优势

标准浏览器自动化在 ARM64 上失败，因为 Puppeteer/Playwright 下载的 x86_64 二进制文件无法运行。我们的解决方案：

• 使用系统安装的 Chromium（原生 ARM64）。
• 为无头 ARM64 操作使用正确的启动标志。
• 符合 MCP 协议，便于与 Claude Code 集成。
• 不依赖预构建的浏览器二进制文件。

架构

graph TB
    A[Claude Code] --> B[MCP Protocol]
    B --> C[ARM64 Browser Server]
    C --> D[System Chromium]
    D --> E[Web Pages]
    
    F[Python Tools] --> C
    G[Direct CLI] --> C

🔧 技术细节

系统要求

• 操作系统：树莓派操作系统（64 位）或任何 ARM64 Linux。
• 内存：最低 4GB，建议 8GB。
• 存储：32GB 以上的快速 SD 卡（Class 10/A2）。
• 浏览器：Chromium（通过 apt 安装）。
• 运行时：Node.js 18+，Python 3.8+。

浏览器配置

// 针对 ARM64 进行优化
{
  executablePath: '/usr/bin/chromium-browser',
  headless: true,
  args: [
    '--no-sandbox',
    '--disable-setuid-sandbox', 
    '--disable-dev-shm-usage',
    '--disable-gpu',
    '--disable-web-security',
    '--disable-features=VizDisplayCompositor'
  ]
}

📄 许可证

本项目采用 MIT 许可证，可自由用于商业项目！

贡献

我们欢迎贡献！本项目旨在为初创公司和创客提供平等的人工智能访问机会。

贡献领域

• 移动浏览器支持（Android/iOS 测试）
• 额外的 MCP 工具和集成
• 针对树莓派 Zero/小型设备的性能优化
• 触摸界面的 UI/UX 改进
• 教程内容和用例示例

开发设置

git clone https://github.com/nfodor/claude-arm64-browser
cd claude-arm64-browser
npm install
# 无需开发服务器 - 即可使用！

完整的低于 500 美元的人工智能启动设置

构建一个完整的人工智能驱动的开发环境，成本低于高端显卡：

你将获得

• 便携式人工智能工作站：4 英寸×3 英寸的体积拥有桌面级性能。
• Claude Sonnet 4 访问权限：具有 20 万上下文窗口的最新人工智能模型。
• 浏览器自动化：网页抓取、测试、监控功能。
• 24/7 运行：始终在线的人工智能助手和自动化。
• 低功耗：系统总功耗 15W（相比传统设置的 500W 以上）。
• 静音运行：无风扇，完全安静。
• 触摸界面：通过内置显示屏直接交互。

初创公司的投资回报率

• 自主测试：人工智能代理测试整个 SaaS 流程，无需人工调试 - 每周节省 40 多个小时。
• 持续验证：24/7 监控确保在客户发现漏洞之前应用程序正常工作。
• 节省 QA 成本：用自动化人工智能验证取代昂贵的手动测试团队。
• 更快的发布：自信地部署，因为人工智能已经测试了所有用户旅程。
• 零回归：自动化视觉和功能测试防止更改破坏现有功能。
• 市场研究：自动化竞争对手分析每周节省 20 多个小时。
• 客户支持：人工智能驱动的响应生成和测试。
• 内容创建：自动化社交媒体监控和内容创意。
• 产品开发：人工智能辅助编码和快速原型制作。

故障排除

MCP 连接问题

• chromium-arm64 显示“✗ 连接失败”

# 检查包装脚本是否存在且可执行
ls -la $(pwd)/mcp-wrapper.sh
chmod +x mcp-wrapper.sh

# 直接测试服务器
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node index.js

# 使用正确的路径重新添加
claude mcp remove chromium-arm64
claude mcp add chromium-arm64 "$(pwd)/mcp-wrapper.sh" --scope user

# 重要：重启 Claude
exit
claude

• Claude 尝试使用 Playwright/Puppeteer 代替
  • 明确指定：在提示中始终提及“chromium-arm64”。
  • 检查可用服务器：claude mcp list。
  • 如果未列出 chromium-arm64，请重启 Claude。
• Claude 会话中显示“未找到服务器”
  • MCP 服务器在启动时加载。
  • 添加/修改 MCP 服务器后始终重启 Claude。
  • 在启动前运行 claude mcp list 进行验证。

常见问题

• 浏览器无法启动

# 检查 Chromium 安装情况
which chromium-browser
chromium-browser --version

# 测试无头模式
chromium-browser --headless --disable-gpu --dump-dom https://example.com

• MCP 连接失败

# 验证 Claude Code MCP 设置
claude mcp list

# 手动测试服务器
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node index.js

• 内存问题

# 监控系统资源
htop

# 优化 Chromium 内存使用
# 添加到浏览器参数：'--memory-pressure-off', '--max_old_space_size=512'

鸣谢

• Anthropic 提供 Claude Code 和 MCP 协议。
• 树莓派基金会 推动计算普及。
• Chromium 项目 提供 ARM64 浏览器支持。
• 开源社区 使这一切成为可能。

脚注

¹ 截至 2025 年的价格（美元，近似值）：

• 树莓派 5 16GB：180 美元（官方建议零售价）
• 树莓派显示屏 2（11.9 英寸触摸屏）：120 美元（官方配件）
• 官方 27W USB - C 电源：25 美元（树莓派 5 推荐）
• 闪迪 Extreme 128GB A2：35 美元（高速 micro SD 卡）
• Claude Code Pro：40 美元/月（2 个月初创期）
• 外壳 + 电缆：40 美元（官方外壳 + HDMI/USB 配件）

价格可能因地区和供应情况而异。请查看官方零售商获取当前价格。