About abc-cli
abc-cli is a command-line tool for managing Apple Business Connect listings, for teams maintaining business locations and their public details. It covers locations, place cards, actions, posts, and insights.
Key features
- 01Search and manage business locations
- 02Manage place cards and categories
- 03Create actions and posts
- 04View location insights
- 05Authenticate with OAuth
Use cases
- 01Update business addresses, phone numbers, and hours
- 02Verify a location or set a temporary closure
- 03Publish location actions and promotional posts
- 04Review search query and directions data
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ dl-alexandre/ skills --skill abc-cliAfter installing, type/abc-cliin Claude Code to confirm it loaded.
Details
From the project READMEApple Business Connect CLI
Manage Apple Business Connect listings using the abc command-line tool.
Prerequisites
abc --version
export ABC_TOKEN='your-oauth-token'
abc auth status
Authentication
- OAuth token from Apple Business Connect
- Environment variable:
ABC_TOKEN - Or:
abc auth loginfor interactive OAuth flow
Business Locations
List & Search
abc locations list --limit 50
abc locations search --query "Apple Store"
abc locations get LOCATION_ID
Create & Update
abc locations create --name "My Business" --address "123 Main St"
abc locations update LOCATION_ID --phone "+1-555-123-4567"
abc locations update LOCATION_ID --hours "mon-fri:9am-5pm,sat:10am-4pm"
Status
abc locations status LOCATION_ID
abc locations verify LOCATION_ID --method postcard
abc locations close LOCATION_ID --temporary --until 2024-12-01
Place Cards
abc placecard get LOCATION_ID
abc placecard update LOCATION_ID --photos ./photos/
abc placecard categories list
abc placecard categories set LOCATION_ID --primary "Restaurant"
Actions & Posts
abc actions list LOCATION_ID
abc actions create LOCATION_ID --type ORDER --url "https://order.example.com"
abc posts list LOCATION_ID
abc posts create LOCATION_ID --title "Summer Special" --photo promo.jpg
Insights
abc insights summary --location LOCATION_ID --days 30
abc insights queries --location LOCATION_ID --start 2024-06-01
abc insights directions --location LOCATION_ID --days 30
Agent Best Practices
- Verification: Required before location appears on Maps
- Hours format: Use comma-separated with dashes
- Photos: Follow Apple's photo guidelines
- Categories: Choose most specific category available
Comments
Markdown supported