skills.rest
rakei076
rakei076COMMUNITY
Explore all skills by this author →
GitHub

alimama-cli

Query Alimama Wanxiangtai advertising reports and pause ad units via CLI.

38|6|Updated May 30, 2026
Search Tags:#cli#roi#ecommerce#advertising#taobao#campaign reporting#alimama
One-click install
npx skills add https://github.com/rakei076/alimama-cli --skill alimama-cli-rakei076
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: alimama-cli
Source: https://github.com/rakei076/alimama-cli
Command: npx skills add https://github.com/rakei076/alimama-cli --skill alimama-cli-rakei076

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires browser-cookie3, curl-cffi, websocket-client, and includes scripts (resource) components.

What problem does it solve? Alimama advertisers need a programmatic way to pull their own store's Wanxiangtai (one.alimama.com / onebp) advertising data—spend, ROI, keywords, campaigns—without manually logging into the web console, plus a guarded way to pause underperforming ad units. ## Core Features & Use Cases - Historical Reports: 11 report types (campaign, keyword, crowd, item, creative, area, realtime, etc.) with spend, impressions, clicks, conversions, and ROI over any date range, plus a machine-readable fields.json dictionary for custom column selection. - Live Campaign Inspection: View currently running campaigns across keyword, crowd, and whole-site promotion scenes, reverse-lookup which campaigns contain a given item ID, and list per-unit on/off status. - Guarded Write Operation: The only write command, promo-off, pauses ad units by item ID; it defaults to dry-run and requires --execute plus user confirmation. - Use Case: Ask your AI agent "which keyword campaigns spent money yesterday with ROI below 1" and it runs report-campaign with jq filtering to surface losing campaigns, then lists the units it would pause before you approve. ## Quick Start Ask the AI to run the alimama-cli doctor command to verify your Chrome login to one.alimama.com, then request yesterday's advertising spend summary.

Frequently Asked Questions about alimama-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Alimama Wanxiangtai ad spend from the command line?▼

Run the charge-summary subcommand with a date to get per-scene spend totals for keyword and crowd promotion. Use report-campaign or report-keyword with --date and --end-date for per-plan or per-keyword spend and ROI breakdowns.

How to find which campaigns contain a specific Taobao item ID?▼

Use promo-units --item <itemId> to query the server-side filtered unit list showing every campaign where that item is promoted and each unit's on/off status. The promo-keyword, promo-crowd, and promo-wholesite commands also support --item reverse lookup.

Does alimama-cli work on Windows without macOS Chrome cookies?▼

Yes. On Windows it launches a dedicated Chrome or Edge profile and reads decrypted cookies via local CDP, compatible with Chrome App-Bound Encryption. You log in once and the profile is reused automatically afterward.

Can this CLI modify bids, budgets, or delete campaigns?▼

No. All query commands are read-only, and the single write operation promo-off only pauses ad units by item ID. It defaults to dry-run listing, requires --execute to act, and never adjusts prices, deletes, or creates anything.

Why does the CLI stop with a risk control or curfew error?▼

It halts when responses contain risk keywords like captcha or re-login prompts, after two consecutive HTTP failures, or during the 1:00-6:00 curfew window. Set ALIMAMA_BYPASS_CURFEW=1 to override the nighttime restriction for debugging.

Related Skills

Explore More Marketing & Sales Skills→
Vinnni002Vinnni002

setup-browser-cookies

Import cookies from Chromium-based browsers into a Playwright session.

Community
Intermediate
faionfaionfaionfaion
4

faion-ppc-manager

Manage and optimize PPC campaigns across Google Ads and Meta Ads.

Community
Advanced
xu1713xu1713

taobao-seller-service

Collects Taobao seller metrics from Sycm via Chrome CDP and writes them into Excel.

Community
Advanced
Bauhaus-InfAUBauhaus-InfAU

interactive-dashboard-builder

Generate self-contained HTML dashboards with Chart.js charts and dropdown filters.

Official
Intermediate