AdsPilot 是一个在本地运行的 AI,连接你的 Google Ads 账号,通过自然语言指令执行广告操作。

Stars

18

7 天增长

暂无数据

Fork 数

20

开放 Issue

0

开源协议

MIT

最近更新

2026-07-27

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它用对话式 AI 替代了传统 Web 控制台,并且所有 OAuth 令牌和凭证完全留存在你的机器上,无需服务器托管,重新定义了广告管理的隐私与自动化边界。

适合谁使用

  • Google Ads 广告主和联盟营销人员
  • 希望用 AI 辅助管理广告活动但无需学习后台界面的非技术用户
  • 为 Google Ads 构建自动化工具的开发者
  • 重视数据隐私和凭证安全的用户

典型使用场景

  • 通过语音或文字指令为产品搜索关键词并创建广告系列
  • 分析现有广告组的表现并获取优化建议
  • 在一个 AI 界面下管理多个 Google Ads 账号
  • 利用多层反作弊系统过滤虚假流量,保护真实广告点击数据

项目优势

  • 隐私优先:OAuth 令牌仅存储在用户本地,不发送至任何远程服务器
  • 四层反作弊流水线:从实时指纹识别到离线转化回溯,层层过滤虚假流量
  • 可插拔架构:轻松接入新的联盟网络、关键词来源或指纹浏览器
  • 开源(MIT)且本地运行,用户拥有完全控制权

使用前须知

  • 项目尚在早期:本地授权流程和 OpenClaw skill 打包仍在开发中
  • 需要 Google Ads Developer Token 和 OAuth 设置,可能存在审批延迟
  • 非 SaaS 方案:用户需自行安装和配置,可能需一定技术基础

README 快速开始

AdsPilot

English version: README.en.md.

一个会投放的 AI,不是一个让你登录的系统。

AdsPilot 不是一个让你登录的后台。你在本地装好、连上你自己的 Google Ads 账号,然后对一个 AI 说话,它替你操作 Google Ads:选 offer 和关键词、建广告和调广告、过滤流量、管理多个账号。

凭证归你自己。 授权在你本机的浏览器里完成(OAuth loopback 流程,和 Claude Code CLI 登录用的是同一套)。你的 Google refresh token 存在你自己机器上,不发往任何服务器。

AdsPilot 是什么

大多数广告工具是个 Web 控制台:你登录、点来点去、手工配置一切。AdsPilot 把它反过来。界面 就是 AI。你用大白话说你要什么,AI 替你驱动 Google Ads API。

  • AI 就是操作者,没有要学的管理后台。
  • 它跑在你这边、你自己的机器上,不是一个替你拿着账号的托管服务。
  • 它设计成以 OpenClaw skill 的形式运行,让非技术用户能在引导下装好;他们遇到的 bug 会变成 对项目的改进。

为什么没有登录系统

传统广告 SaaS 需要登录系统、订阅计费、多租户权限、托管你的 token,因为它的架构是"平台替你 干活"。AdsPilot 的架构是"AI 替你干活"。你在本地装好、在自己浏览器里完成 Google 授权,token 归你自己。AI 直接操作 API,中间不需要一个 Web 后台。登录系统、计费、多租户、token 托管在这 个范式下不需要存在,所以它们就不存在。

四块核心能力

1. 联盟 API 对接。 可插拔的 AffiliateProvider 接口。AI 从联盟的第一方结构化数据里选 offer、写广告文案。接新联盟只需实现接口,不动主干。

2. Google Ads 关键词数据。 KeywordProvider 接口抽象关键词来源。Google Ads API 是首发 实现;API 还没批下来时,CSV 导入自动兜底,系统不停摆。

3. 真实流量源 + 反作弊过滤。 买来的真实流量经埋点入库,四层过滤假流量:

机制延迟
第一层入口指纹(IP 情报、UA 异常、头一致性)毫秒级,同步
第二层频率窗口(同 IP/指纹在时间窗内的点击频次)毫秒级,Redis 计数
第三层行为信号(停留时间、交互、JS 执行)秒级,异步回填
第四层转化回溯(联盟回传拒付,反标到对应点击)天级,离线批处理

IP 情报可插拔(IPIntelProvider,首发 IPQS)。实时规则引擎和离线 ML 模型双引擎并行:冷启动 靠规则扛,样本够了模型接管。这里的"反作弊"是把假流量过滤掉,不是制造假流量。

4. 多账户管理。 Google Ads MCC 管理多账户数据,BrowserProvider 接口对接指纹浏览器(首 发 AdsPower),实现多账户会话隔离。

怎么用

  1. 安装:通过 OpenClaw(或克隆下来本地跑,用于开发)。
  2. 授权:本机的浏览器流程连上你的 Google Ads 账号。token 只写到你的机器上。配置和完整流程见 本地授权指南
  3. 操作:告诉 AI 你要什么("给这个产品找关键词"、"给这个 offer 开个广告系列"、"这个广 告组为什么跑不动"),它用 Google Ads API 去做。

可插拔架构

每个第三方集成都走 provider 接口,新增同类只需实现接口,不改主干。

Provider接口首发实现
联盟AffiliateProviderCJ / Impact
关键词KeywordProviderGoogle Ads API
流量源TrafficProviderNative
IP 情报IPIntelProviderIPQS
AIAIProviderClaude / DeepSeek
指纹浏览器BrowserProviderAdsPower

模块

能力层是一组独立的 Go 服务模块,通过 Go workspace(go.work)串起来。

模块职责状态
adscenterGoogle Ads API:账户、关键词、广告系列、MCC已建
aicoreAI 抽象层(选 offer、设计广告、反作弊推理)已建
siterank站点和关键词排名信号已建
recommendations优化建议已建
proxy-pool中性 IP 路由基础设施已建
gateway-middleware边缘鉴权和路由已建
bff聚合层已建
projector事件投影和读模型已建
useractivity活动追踪已建
`consol

项目描述

Google Ads optimization and monetization automation platform.

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

TanStack
精选
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web 开发前端框架
14,861
vercel-labs
精选
vercel-labs GitHub avatar

scriptc

scriptc compiles ordinary TypeScript into small, fast native executables without needing Node.js, V8, or any JavaScript runtime in the binary.

开发者工具代码质量与构建
1,985
Jakubantalik
精选
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI 与机器学习AI 智能体
1,191