# @adkit/cli 中文文档

规范地址：https://npmcn.com/package/%40adkit/cli/

版本：1\.13\.57
npm 元数据更新时间：2026-11-07T01:19:57.437Z
中文译文更新时间：2026-11-07T01:27:03.847Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adkit/cli
原文对照：https://npmcn.com/package/%40adkit/cli/?lang=original
项目主页：https://adkit.so/

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：629 kB，3 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-06-07T05:53:54.111Z
- 最新版本发布：2026-11-07T01:19:57.242Z
- 近 30 天下载量：2405（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：84（近 12 个月 84 个）

## 中文简介

AI代理的Ads CLI——管理Meta & Google的广告活动,浏览广告库,并从您的终端生成创意.

## 安装

```sh
npm install @adkit/cli
```

也可以使用：`pnpm add @adkit/cli`、`yarn add @adkit/cli`、`bun add @adkit/cli`

## README

# AdKit – AI代理的Ads CLI

这个 **广告CLI** 给人工智能特工和人类 管理 Meta & Google 的广告活动,浏览广告库,并产生创意——都来自您的终端. 部分 [阿德基特语Name](https://adkit.so/)。 。 。 .

## 安装

```bash
npm install -g @adkit/cli
```

安装的命令是 `adkit`。 。 。 .

## 认证

```bash
adkit setup
```

打开浏览器连接您的 AdKit 账户。 您的 API 密钥是本地存储的 .

## 图标

```
adkit status                  Show current project and connected accounts
adkit setup                   Authenticate (opens browser)
adkit projects                Manage projects
adkit library                 Browse the ad library
adkit studio                  Create and manage Studio ads
adkit manage                  Manage live campaigns on Meta and Google
adkit logout                  Remove stored credentials
```

### 项目

```bash
adkit projects list
adkit projects create --name "Example" --website example.com
adkit projects use <id>
adkit projects current
```

### 临时图书馆

浏览共享的 ad 库或您的工程的 My 监视列表 . `add` 找到或创建广告商并将其保存到该项目; `track` 财务报告和审定财务报表 `untrack` 更改现有身份证的会员资格。 重复要么是安全的。 无轨电车保持了共享广告商和其他项目的完整.

```bash
adkit library advertisers list --scope watchlist --project <project-id>
adkit library advertisers search "notion" --scope watchlist --project <project-id>
adkit library advertisers add --website notion.so --project <project-id>
adkit library advertisers track <id> --project <project-id>
adkit library advertisers untrack <id> --project <project-id>
adkit library advertisers search "notion" --platform meta
adkit library advertisers <id>
adkit library advertisers similar --industry saas
adkit library ads list --advertiser <id>
adkit library ads <id>
```

奥米 `--scope` (或使用) `--scope library`为了整个图书馆。 列表/ 搜索默认值为最先更新; 使用 `--sort name` 字母顺序。 使用 `--json` 用于自动化.

### 工作室

创建并管理AI生成的广告.

```bash
adkit studio ads list
adkit studio ads generate --ref media:<id> --mode clone
adkit studio ads <id>
adkit studio media upload ./banner.png
adkit studio media list <ad-id>
```

### Meta (Facebook / Instagram) (中文(简体) )

**账户**

```bash
adkit manage meta accounts list
adkit manage meta accounts connect
adkit manage meta accounts disconnect <id>
```

**运动**

```bash
adkit manage meta campaigns list
adkit manage meta campaigns create --name "Spring Sale" --objective sales --budget-daily 50 --publish
adkit manage meta campaigns update <id> --status paused
adkit manage meta campaigns delete <id>
adkit manage meta campaigns <id>
```

**自动集**

```bash
adkit manage meta adsets list
adkit manage meta adsets create --campaign <id> --name "US Broad" \
  --optimization conversions --conversion-goals purchase --countries US --budget-daily 20 --publish
adkit manage meta adsets update <id> --budget-daily 50
adkit manage meta adsets delete <id>
```

**广告**

```bash
adkit manage meta ads list
adkit manage meta ads create --adset <id> --media ./image.jpg \
  --primary-text "Try it free" --headline "AdKit" --cta sign_up --url https://example.com --publish
adkit manage meta ads create --adset <id> \
  --media ./feed.jpg --media ./story.mp4 --media-format default --media-format vertical \
  --primary-text "Try it free" --headline "AdKit" --url https://example.com --publish
adkit manage meta ads update <id> --status paused
adkit manage meta ads delete <id>
adkit manage meta ads <id>
```

**成果和研究**

```bash
adkit manage meta results                        # Spend, clicks, conversions
adkit manage meta research interests "saas tools"
adkit manage meta pages list
adkit manage meta pixels list
```

**草稿**

```bash
adkit manage drafts list
adkit manage drafts <id>
adkit manage drafts publish <id>
adkit manage drafts delete <id>
```

### 谷歌广告

**账户**

```bash
adkit manage google accounts list
adkit manage google accounts connect
adkit manage google accounts disconnect <id>
```

**运动**

```bash
adkit manage google campaigns list --account <id>
adkit manage google campaigns create --name "Search Test" --campaign-type search --budget-daily 5 --account <id> --publish
adkit manage google campaigns update <id> --status paused --account <id>
adkit manage google campaigns delete <id> --account <id>
```

**Ad Groups, Ads, 关键词**

```bash
adkit manage google ad-groups list --campaign <id> --account <id>
adkit manage google ads list --ad-group <id> --account <id>
adkit manage google keywords list --ad-group <id> --account <id>
adkit manage google keywords add --ad-group <id> --text "project management software" --match-type broad --account <id>
adkit manage google negative-keywords add --campaign <id> --text "free" --account <id>
```

**资产(呼叫、站点链接、片段、呼叫扩展)**

```bash
adkit manage google assets list --type callout --account <id>
adkit manage google assets create --type callout --text "Free 14-day trial" --account <id>
adkit manage google assets create --type sitelink --sitelink "Pricing|https://example.com/pricing" \
  --description-1 "See all plans" --description-2 "Starts free" --account <id>
adkit manage google assets create --type call --country-code US --phone-number "+14155551234" --account <id>
adkit manage google assets attach asset:<id> --type callout --scope campaign --scope-id <id> --account <id>
```

**成果和研究**

```bash
adkit manage google results --account <id>
adkit manage google search-terms --account <id>
adkit manage google research keywords "project management" --account <id>
```

## 全球旗帜

```
--json        Force JSON output (default when stdout is not a TTY)
--project     Override the active project for this command
--help        Show help  (--help full for complete field reference)
```

## 代理/ 程序使用

所有命令在 Stdout 不是一个 TTY 时自动输出 JSON, 制作 `adkit` aI代理或脚本中易于使用:

```bash
adkit manage meta campaigns list --json | jq '.[].name'
```

将项目创建为草稿( 默认) 并单独分步发布, 或通过 `--publish` 马上去现场直播.

## 再来

-   文档 : [adkit.so/ 文档](https://adkit.so/docs)

## 常见问题

### @adkit/cli 是什么？

AI代理的Ads CLI——管理Meta & Google的广告活动,浏览广告库,并从您的终端生成创意\.

### 如何安装 @adkit/cli？

在项目目录运行 npm install @adkit/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 adkit，可以用 npx adkit 直接运行。

### @adkit/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adkit\_\_cli 是否存在。

### @adkit/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adkit/cli 可以商用吗？

@adkit/cli 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @adkit/cli 的下载量有多少？

根据 npm 官方下载统计，@adkit/cli 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,405 次，日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adkit/cli 还在维护吗？

最新版本 1\.13\.57 发布于 2026/11/07（今天）；至今共发布 84 个版本，其中过去 12 个月发布了 84 个；首次发布于 2026/06/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。