{
  "schemaVersion": "1.0",
  "item": {
    "slug": "apple-search-ads-skill",
    "name": "Apple Search Ads",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/TrebuhS/apple-search-ads-skill",
    "canonicalUrl": "https://clawhub.ai/TrebuhS/apple-search-ads-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/apple-search-ads-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-search-ads-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/apple-search-ads-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/apple-search-ads-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/apple-search-ads-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-search-ads-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-search-ads-skill/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Apple Search Ads CLI",
        "body": "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."
      },
      {
        "title": "Organizations",
        "body": "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."
      },
      {
        "title": "Auth & Config",
        "body": "asa-cli whoami                          # List all orgs (no --org-id needed)\nasa-cli configure --client-id \"...\" --team-id \"...\" --key-id \"...\" --private-key-path \"...\"\nasa-cli configure                       # Interactive mode"
      },
      {
        "title": "Campaigns",
        "body": "asa-cli campaigns list [--org-id <orgid>] [--limit N] [--offset N]\nasa-cli campaigns get <id> [--org-id <orgid>]\nasa-cli campaigns find [--org-id <orgid>] [--filter \"status=ENABLED\"] [--sort \"name:asc\"] [--limit N] [--all]\nasa-cli campaigns create [--org-id <orgid>] --name \"...\" --budget 1000 --daily-budget 50 --countries US,GB --app-id 123456\nasa-cli campaigns update <id> [--org-id <orgid>] [--name ...] [--budget ...] [--daily-budget ...] [--status ENABLED|PAUSED]\nasa-cli campaigns delete <id> [--org-id <orgid>]"
      },
      {
        "title": "Ad Groups (require --campaign-id)",
        "body": "asa-cli adgroups list --campaign-id <id> [--org-id <orgid>]\nasa-cli adgroups get <id> --campaign-id <id> [--org-id <orgid>]\nasa-cli adgroups find --campaign-id <id> [--org-id <orgid>] [--filter \"status=ENABLED\"]\nasa-cli adgroups create --campaign-id <id> [--org-id <orgid>] --name \"...\" --default-bid 1.50 --start-time \"2026-01-01T00:00:00.000\" [--cpa-goal 5.00] [--auto-keywords true|false]\nasa-cli adgroups update <id> --campaign-id <id> [--org-id <orgid>] [--name ...] [--default-bid ...] [--status ...]\nasa-cli adgroups delete <id> --campaign-id <id> [--org-id <orgid>]"
      },
      {
        "title": "Keywords (require --campaign-id --adgroup-id)",
        "body": "asa-cli keywords list --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]\nasa-cli keywords get <kwid> --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]\nasa-cli keywords find --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] [--filter \"text~brand\"]\nasa-cli keywords create --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] --text \"keyword\" [--text \"another\"] --match-type BROAD|EXACT [--bid 1.50]\nasa-cli keywords update --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] --id <kwid> [--status ACTIVE|PAUSED] [--bid 2.00]\nasa-cli keywords delete <kwid,kwid2> --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]"
      },
      {
        "title": "Negative Keywords",
        "body": "# Campaign-level\nasa-cli negative-keywords campaign-list --campaign-id <id> [--org-id <orgid>]\nasa-cli negative-keywords campaign-find --campaign-id <id> [--org-id <orgid>] [--filter \"text~free\"]\nasa-cli negative-keywords campaign-create --campaign-id <id> [--org-id <orgid>] --text \"term\" [--text \"another\"] --match-type EXACT|BROAD\nasa-cli negative-keywords campaign-delete <kwid,...> --campaign-id <id> [--org-id <orgid>]\n\n# Ad group-level\nasa-cli negative-keywords adgroup-list --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]\nasa-cli negative-keywords adgroup-find --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] [--filter \"text~competitor\"]\nasa-cli negative-keywords adgroup-create --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] --text \"term\" [--text \"another\"] --match-type EXACT|BROAD\nasa-cli negative-keywords adgroup-delete <kwid,...> --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]"
      },
      {
        "title": "Reports",
        "body": "asa-cli reports campaigns [--org-id <orgid>] --start-date 2024-01-01 --end-date 2024-01-31 [--granularity DAILY|WEEKLY|MONTHLY] [--group-by countryOrRegion,deviceClass]\nasa-cli reports adgroups --campaign-id <id> [--org-id <orgid>] --start-date ... --end-date ...\nasa-cli reports keywords --campaign-id <id> [--org-id <orgid>] --start-date ... --end-date ...\nasa-cli reports search-terms --campaign-id <id> [--org-id <orgid>] --start-date ... --end-date ..."
      },
      {
        "title": "Utilities",
        "body": "asa-cli apps search --query \"MyApp\" [--owned]\nasa-cli geo search --query \"US\" [--entity ...] [--country-code ...]"
      },
      {
        "title": "Filter Syntax",
        "body": "Operators for --filter: = EQUALS, ~ CONTAINS, @ IN (comma-sep), > GT, < LT, >= GTE, <= LTE, !~ NOT_CONTAINS.\n\nExample: --filter \"status=ENABLED\" --filter \"name~Brand\""
      },
      {
        "title": "Global Flags",
        "body": "FlagShortDescription--output-ojson or table (default: table)--org-idOrganization ID — required for multi-org accounts, auto-detected for single-org--profile-pNamed config profile--verbose-vShow HTTP request/response details--no-colorDisable colored output"
      },
      {
        "title": "Config",
        "body": "Config stored at ~/.asa-cli/config.yaml, token cache at ~/.asa-cli/token_cache.json\nProfiles: asa-cli configure -p production --client-id \"...\" ..., then asa-cli campaigns list -p production\nEnv var overrides: ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID, ASA_ORG_ID, ASA_PRIVATE_KEY_PATH"
      },
      {
        "title": "Guidelines",
        "body": "Always use -o json and pipe through jq when extracting specific fields\nFor multi-org accounts, always include --org-id — run asa-cli whoami -o json to discover org IDs\nFetch campaign/adgroup IDs first before operating on child resources\nUse --all on find commands to auto-paginate large result sets\nReports require --start-date and --end-date in YYYY-MM-DD format\nCurrency is auto-detected from the org — no need to specify it manually\nAd group create requires --start-time (ISO 8601 format, e.g. \"$(date -u +%Y-%m-%dT%H:%M:%S.000)\" for now)\n--auto-keywords defaults to false (search match OFF). Only enable explicitly when creating discovery ad groups\nkeywords find may return 404 on paused/deleted campaigns — use keywords list as a fallback\nDefault pagination limit is 20. Use --limit 50 (or higher) when expecting more results (e.g. negative keywords)\nReport metrics use v5 field names: totalInstalls, tapInstalls, viewInstalls, totalNewDownloads, totalRedownloads, totalInstallRate, tapInstallRate, totalAvgCPI, tapInstallCPI, avgCPM — not the old v4 names\nUse --grand-totals on campaign reports to get aggregated totals across all campaigns"
      }
    ],
    "body": "Apple Search Ads CLI\n\nUse asa-cli to interact with the Apple Search Ads Campaign Management API v5. Always use -o json when you need to parse results programmatically.\n\nOrganizations\n\nRun 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.\n\nCommands\nAuth & Config\nasa-cli whoami                          # List all orgs (no --org-id needed)\nasa-cli configure --client-id \"...\" --team-id \"...\" --key-id \"...\" --private-key-path \"...\"\nasa-cli configure                       # Interactive mode\n\nCampaigns\nasa-cli campaigns list [--org-id <orgid>] [--limit N] [--offset N]\nasa-cli campaigns get <id> [--org-id <orgid>]\nasa-cli campaigns find [--org-id <orgid>] [--filter \"status=ENABLED\"] [--sort \"name:asc\"] [--limit N] [--all]\nasa-cli campaigns create [--org-id <orgid>] --name \"...\" --budget 1000 --daily-budget 50 --countries US,GB --app-id 123456\nasa-cli campaigns update <id> [--org-id <orgid>] [--name ...] [--budget ...] [--daily-budget ...] [--status ENABLED|PAUSED]\nasa-cli campaigns delete <id> [--org-id <orgid>]\n\nAd Groups (require --campaign-id)\nasa-cli adgroups list --campaign-id <id> [--org-id <orgid>]\nasa-cli adgroups get <id> --campaign-id <id> [--org-id <orgid>]\nasa-cli adgroups find --campaign-id <id> [--org-id <orgid>] [--filter \"status=ENABLED\"]\nasa-cli adgroups create --campaign-id <id> [--org-id <orgid>] --name \"...\" --default-bid 1.50 --start-time \"2026-01-01T00:00:00.000\" [--cpa-goal 5.00] [--auto-keywords true|false]\nasa-cli adgroups update <id> --campaign-id <id> [--org-id <orgid>] [--name ...] [--default-bid ...] [--status ...]\nasa-cli adgroups delete <id> --campaign-id <id> [--org-id <orgid>]\n\nKeywords (require --campaign-id --adgroup-id)\nasa-cli keywords list --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]\nasa-cli keywords get <kwid> --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]\nasa-cli keywords find --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] [--filter \"text~brand\"]\nasa-cli keywords create --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] --text \"keyword\" [--text \"another\"] --match-type BROAD|EXACT [--bid 1.50]\nasa-cli keywords update --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] --id <kwid> [--status ACTIVE|PAUSED] [--bid 2.00]\nasa-cli keywords delete <kwid,kwid2> --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]\n\nNegative Keywords\n# Campaign-level\nasa-cli negative-keywords campaign-list --campaign-id <id> [--org-id <orgid>]\nasa-cli negative-keywords campaign-find --campaign-id <id> [--org-id <orgid>] [--filter \"text~free\"]\nasa-cli negative-keywords campaign-create --campaign-id <id> [--org-id <orgid>] --text \"term\" [--text \"another\"] --match-type EXACT|BROAD\nasa-cli negative-keywords campaign-delete <kwid,...> --campaign-id <id> [--org-id <orgid>]\n\n# Ad group-level\nasa-cli negative-keywords adgroup-list --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]\nasa-cli negative-keywords adgroup-find --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] [--filter \"text~competitor\"]\nasa-cli negative-keywords adgroup-create --campaign-id <id> --adgroup-id <id> [--org-id <orgid>] --text \"term\" [--text \"another\"] --match-type EXACT|BROAD\nasa-cli negative-keywords adgroup-delete <kwid,...> --campaign-id <id> --adgroup-id <id> [--org-id <orgid>]\n\nReports\nasa-cli reports campaigns [--org-id <orgid>] --start-date 2024-01-01 --end-date 2024-01-31 [--granularity DAILY|WEEKLY|MONTHLY] [--group-by countryOrRegion,deviceClass]\nasa-cli reports adgroups --campaign-id <id> [--org-id <orgid>] --start-date ... --end-date ...\nasa-cli reports keywords --campaign-id <id> [--org-id <orgid>] --start-date ... --end-date ...\nasa-cli reports search-terms --campaign-id <id> [--org-id <orgid>] --start-date ... --end-date ...\n\nUtilities\nasa-cli apps search --query \"MyApp\" [--owned]\nasa-cli geo search --query \"US\" [--entity ...] [--country-code ...]\n\nFilter Syntax\n\nOperators for --filter: = EQUALS, ~ CONTAINS, @ IN (comma-sep), > GT, < LT, >= GTE, <= LTE, !~ NOT_CONTAINS.\n\nExample: --filter \"status=ENABLED\" --filter \"name~Brand\"\n\nGlobal Flags\nFlag\tShort\tDescription\n--output\t-o\tjson or table (default: table)\n--org-id\t\tOrganization ID — required for multi-org accounts, auto-detected for single-org\n--profile\t-p\tNamed config profile\n--verbose\t-v\tShow HTTP request/response details\n--no-color\t\tDisable colored output\nConfig\nConfig stored at ~/.asa-cli/config.yaml, token cache at ~/.asa-cli/token_cache.json\nProfiles: asa-cli configure -p production --client-id \"...\" ..., then asa-cli campaigns list -p production\nEnv var overrides: ASA_CLIENT_ID, ASA_TEAM_ID, ASA_KEY_ID, ASA_ORG_ID, ASA_PRIVATE_KEY_PATH\nGuidelines\nAlways use -o json and pipe through jq when extracting specific fields\nFor multi-org accounts, always include --org-id — run asa-cli whoami -o json to discover org IDs\nFetch campaign/adgroup IDs first before operating on child resources\nUse --all on find commands to auto-paginate large result sets\nReports require --start-date and --end-date in YYYY-MM-DD format\nCurrency is auto-detected from the org — no need to specify it manually\nAd group create requires --start-time (ISO 8601 format, e.g. \"$(date -u +%Y-%m-%dT%H:%M:%S.000)\" for now)\n--auto-keywords defaults to false (search match OFF). Only enable explicitly when creating discovery ad groups\nkeywords find may return 404 on paused/deleted campaigns — use keywords list as a fallback\nDefault pagination limit is 20. Use --limit 50 (or higher) when expecting more results (e.g. negative keywords)\nReport metrics use v5 field names: totalInstalls, tapInstalls, viewInstalls, totalNewDownloads, totalRedownloads, totalInstallRate, tapInstallRate, totalAvgCPI, tapInstallCPI, avgCPM — not the old v4 names\nUse --grand-totals on campaign reports to get aggregated totals across all campaigns"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/TrebuhS/apple-search-ads-skill",
    "publisherUrl": "https://clawhub.ai/TrebuhS/apple-search-ads-skill",
    "owner": "TrebuhS",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/apple-search-ads-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/apple-search-ads-skill",
    "agentUrl": "https://openagent3.xyz/skills/apple-search-ads-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-search-ads-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-search-ads-skill/agent.md"
  }
}