← 返回 Skills 市场
trebuhs

Apple Search Ads

作者 TrebuhS · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
785
总下载
2
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install apple-search-ads-skill
功能描述
Manage Apple Search Ads campaigns, ad groups, keywords, and reports via the asa-cli tool. Use when the user asks about Apple Search Ads management, campaign...
使用说明 (SKILL.md)

Apple Search Ads CLI

Use asa-cli to interact with the Apple Search Ads Campaign Management API v5. Always use -o json when you need to parse results programmatically.

Organizations

Run asa-cli whoami to list available orgs. For multi-org accounts, pass --org-id with every command (except whoami). Single-org accounts auto-detect the org.

Commands

Auth & Config

asa-cli whoami                          # List all orgs (no --org-id needed)
asa-cli configure --client-id "..." --team-id "..." --key-id "..." --private-key-path "..."
asa-cli configure                       # Interactive mode

Campaigns

asa-cli campaigns list [--org-id \x3Corgid>] [--limit N] [--offset N]
asa-cli campaigns get \x3Cid> [--org-id \x3Corgid>]
asa-cli campaigns find [--org-id \x3Corgid>] [--filter "status=ENABLED"] [--sort "name:asc"] [--limit N] [--all]
asa-cli campaigns create [--org-id \x3Corgid>] --name "..." --budget 1000 --daily-budget 50 --countries US,GB --app-id 123456
asa-cli campaigns update \x3Cid> [--org-id \x3Corgid>] [--name ...] [--budget ...] [--daily-budget ...] [--status ENABLED|PAUSED]
asa-cli campaigns delete \x3Cid> [--org-id \x3Corgid>]

Ad Groups (require --campaign-id)

asa-cli adgroups list --campaign-id \x3Cid> [--org-id \x3Corgid>]
asa-cli adgroups get \x3Cid> --campaign-id \x3Cid> [--org-id \x3Corgid>]
asa-cli adgroups find --campaign-id \x3Cid> [--org-id \x3Corgid>] [--filter "status=ENABLED"]
asa-cli adgroups create --campaign-id \x3Cid> [--org-id \x3Corgid>] --name "..." --default-bid 1.50 --start-time "2026-01-01T00:00:00.000" [--cpa-goal 5.00] [--auto-keywords true|false]
asa-cli adgroups update \x3Cid> --campaign-id \x3Cid> [--org-id \x3Corgid>] [--name ...] [--default-bid ...] [--status ...]
asa-cli adgroups delete \x3Cid> --campaign-id \x3Cid> [--org-id \x3Corgid>]

Keywords (require --campaign-id --adgroup-id)

asa-cli keywords list --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>]
asa-cli keywords get \x3Ckwid> --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>]
asa-cli keywords find --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>] [--filter "text~brand"]
asa-cli keywords create --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>] --text "keyword" [--text "another"] --match-type BROAD|EXACT [--bid 1.50]
asa-cli keywords update --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>] --id \x3Ckwid> [--status ACTIVE|PAUSED] [--bid 2.00]
asa-cli keywords delete \x3Ckwid,kwid2> --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>]

Negative Keywords

# Campaign-level
asa-cli negative-keywords campaign-list --campaign-id \x3Cid> [--org-id \x3Corgid>]
asa-cli negative-keywords campaign-find --campaign-id \x3Cid> [--org-id \x3Corgid>] [--filter "text~free"]
asa-cli negative-keywords campaign-create --campaign-id \x3Cid> [--org-id \x3Corgid>] --text "term" [--text "another"] --match-type EXACT|BROAD
asa-cli negative-keywords campaign-delete \x3Ckwid,...> --campaign-id \x3Cid> [--org-id \x3Corgid>]

# Ad group-level
asa-cli negative-keywords adgroup-list --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>]
asa-cli negative-keywords adgroup-find --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>] [--filter "text~competitor"]
asa-cli negative-keywords adgroup-create --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>] --text "term" [--text "another"] --match-type EXACT|BROAD
asa-cli negative-keywords adgroup-delete \x3Ckwid,...> --campaign-id \x3Cid> --adgroup-id \x3Cid> [--org-id \x3Corgid>]

Reports

asa-cli reports campaigns [--org-id \x3Corgid>] --start-date 2024-01-01 --end-date 2024-01-31 [--granularity DAILY|WEEKLY|MONTHLY] [--group-by countryOrRegion,deviceClass]
asa-cli reports adgroups --campaign-id \x3Cid> [--org-id \x3Corgid>] --start-date ... --end-date ...
asa-cli reports keywords --campaign-id \x3Cid> [--org-id \x3Corgid>] --start-date ... --end-date ...
asa-cli reports search-terms --campaign-id \x3Cid> [--org-id \x3Corgid>] --start-date ... --end-date ...

Utilities

asa-cli apps search --query "MyApp" [--owned]
asa-cli geo search --query "US" [--entity ...] [--country-code ...]

Filter Syntax

Operators for --filter: = EQUALS, ~ CONTAINS, @ IN (comma-sep), > GT, \x3C LT, >= GTE, \x3C= LTE, !~ NOT_CONTAINS.

Example: --filter "status=ENABLED" --filter "name~Brand"

Global Flags

Flag Short Description
--output -o json or table (default: table)
--org-id Organization ID — required for multi-org accounts, auto-detected for single-org
--profile -p Named config profile
--verbose -v Show HTTP request/response details
--no-color Disable colored output

Config

  • Config stored at ~/.asa-cli/config.yaml, token cache at ~/.asa-cli/token_cache.json
  • Profiles: asa-cli configure -p production --client-id "..." ..., then asa-cli campaigns list -p production
  • Env var overrides: ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID, ASA_ORG_ID, ASA_PRIVATE_KEY_PATH

Guidelines

  • Always use -o json and pipe through jq when extracting specific fields
  • For multi-org accounts, always include --org-id — run asa-cli whoami -o json to discover org IDs
  • Fetch campaign/adgroup IDs first before operating on child resources
  • Use --all on find commands to auto-paginate large result sets
  • Reports require --start-date and --end-date in YYYY-MM-DD format
  • Currency is auto-detected from the org — no need to specify it manually
  • Ad group create requires --start-time (ISO 8601 format, e.g. "$(date -u +%Y-%m-%dT%H:%M:%S.000)" for now)
  • --auto-keywords defaults to false (search match OFF). Only enable explicitly when creating discovery ad groups
  • keywords find may return 404 on paused/deleted campaigns — use keywords list as a fallback
  • Default pagination limit is 20. Use --limit 50 (or higher) when expecting more results (e.g. negative keywords)
  • Report metrics use v5 field names: totalInstalls, tapInstalls, viewInstalls, totalNewDownloads, totalRedownloads, totalInstallRate, tapInstallRate, totalAvgCPI, tapInstallCPI, avgCPM — not the old v4 names
  • Use --grand-totals on campaign reports to get aggregated totals across all campaigns
安全使用建议
This skill looks like a straightforward guide for using the asa-cli tool — it is coherent with its purpose. Before installing or using it: (1) Ensure you have asa-cli from a trusted source (the skill does not install it for you). (2) Be aware the commands will read/write ~/.asa-cli/config.yaml and token_cache.json and may read a local private key file you point to; avoid providing private keys you don't trust. (3) The skill metadata omitted declaring required binaries and optional env vars (ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID, ASA_PRIVATE_KEY_PATH), so provide only the minimal credentials/scopes needed (or use ephemeral credentials). (4) If you want to limit blast radius, run these commands in an isolated environment or review ~/.asa-cli/ contents after use. (5) If you need higher assurance, ask the publisher for the asa-cli binary source and a manifest so you can verify it before running.
功能分析
Type: OpenClaw Skill Name: apple-search-ads-skill Version: 1.0.0 The skill is classified as suspicious due to its reliance on executing external shell commands (`asa-cli`) and handling sensitive credentials, specifically the `--private-key-path` argument in the `asa-cli configure` command, as detailed in `SKILL.md`. While these capabilities are necessary for the stated purpose of managing Apple Search Ads, they represent high-risk operations. The direct execution of external commands and interaction with file paths for private keys could be exploited through vulnerabilities in the agent's input sanitization or the `asa-cli` tool itself, even though the skill itself does not explicitly instruct malicious behavior.
能力评估
ℹ Purpose & Capability
The SKILL.md clearly targets Apple Search Ads and documents asa-cli commands for campaigns, ad groups, keywords, and reports — that matches the skill name/description. However, the metadata declares no required binaries or credentials while the instructions assume the presence of the asa-cli binary and Apple Search Ads credentials (client-id, team-id, key-id, private key path or env vars). This is a minor inconsistency in metadata vs runtime expectations, not an indication of hidden behavior.
✓ Instruction Scope
The runtime instructions remain focused on ASA management and related utilities (jq, date). They do reference reading/writing the ASA CLI config and token cache in ~/.asa-cli/ and using a local private key path; these filesystem actions are expected for a CLI-based integration and are within the stated scope.
✓ Install Mechanism
This is an instruction-only skill with no install spec and no code files, so there is nothing being downloaded or written by the skill itself. The only install expectation is that the asas-cli binary (asa-cli) is present on PATH — the metadata should have declared that but did not.
ℹ Credentials
The SKILL.md documents environment variable overrides (ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID, ASA_ORG_ID, ASA_PRIVATE_KEY_PATH) and describes use of a private key file and token cache. The metadata lists no required env vars or primary credential. The credentials referenced are appropriate for Apple Search Ads usage, but the metadata omission is an inconsistency the user should be aware of.
✓ Persistence & Privilege
The skill does not request always:true and does not modify other skills. It will read/write its own CLI config under ~/.asa-cli/, which is normal for a CLI integration and within scope.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install apple-search-ads-skill
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /apple-search-ads-skill 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of Apple Search Ads management skill. - Provides full command reference for managing Apple Search Ads campaigns, ad groups, keywords, and reports via `asa-cli`. - Includes guidance for authentication, multi-org management, filtering, pagination, and output formatting. - Documents relevant global flags, config options, and environment variable overrides. - Lists recommended best practices for command usage, reporting, and troubleshooting common scenarios.
元数据
Slug apple-search-ads-skill
版本 1.0.0
许可证 —
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Apple Search Ads 是什么？

Manage Apple Search Ads campaigns, ad groups, keywords, and reports via the asa-cli tool. Use when the user asks about Apple Search Ads management, campaign... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 785 次。

如何安装 Apple Search Ads？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install apple-search-ads-skill」即可一键安装，无需额外配置。

Apple Search Ads 是免费的吗？

是的，Apple Search Ads 完全免费（开源免费），可自由下载、安装和使用。

Apple Search Ads 支持哪些平台？

Apple Search Ads 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Apple Search Ads？

由 TrebuhS（@trebuhs）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463368 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259467 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200457 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191163 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190189 · by oswalpalash

💬 留言讨论