Automate Google My Business with nanoclaw

Publish business updates, promote events, share offers with coupon codes, and add call-to-action buttons — all from the command line or through your AI agent to boost local SEO.

Setup Guide GitHub

Please make sure there is always a human in the loop.

Post to Google My Business in Seconds

Terminal

# Install the skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Find your Google My Business integration
postiz integrations:list

# Create a business update post
postiz posts:create \
  -c "Visit us today! We have exciting new products in store." \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"topicType":"STANDARD","callToActionType":"LEARN_MORE","callToActionUrl":"https://example.com"}' \
  -i "your-gmb-integration-id"

Google My Business Features

📣

Business Posts

Publish standard business updates that appear on your Google Business Profile. Keep customers informed about news, products, and services.

📅

Event Promotion

Create event posts with title, start and end dates, and times. Promote workshops, sales events, grand openings, and more.

🏷️

Offers & Coupons

Share special offers with coupon codes, redemption URLs, and terms. Drive foot traffic with exclusive deals and promotions.

🔗

Call-to-Action Buttons

Add CTA buttons like Book, Order, Shop, Learn More, Sign Up, Get Offer, or Call. Drive customer actions directly from your posts.

📍

Local SEO Boost

Regular Google My Business posts improve your local search ranking. Stay active and visible in Google Maps and local search results.

⏰

Scheduled Posting

Schedule posts with precise timestamps. Plan your business updates ahead of time and maintain consistent posting frequency.

How It Works

Find Your GMB Integration

List your connected accounts and grab your Google My Business integration ID. You can also fetch available settings to see what options are supported.

Discovery

# List all integrations
postiz integrations:list

# Filter for Google My Business
postiz integrations:list | jq \
  '.[] | select(.identifier=="gmb")'

# Get GMB settings schema
postiz integrations:settings <gmb-id>

Choose Your Post Type

Select the type of post: STANDARD for general updates, EVENT for promoting events with dates and times, or OFFER for sharing deals with coupon codes.

Configuration

# Standard business update
echo '{"topicType": "STANDARD"}'

# Event with dates
echo '{
  "topicType": "EVENT",
  "eventTitle": "Grand Opening",
  "eventStartDate": "2025-03-15",
  "eventEndDate": "2025-03-15",
  "eventStartTime": "10:00",
  "eventEndTime": "18:00"
}'

# Offer with coupon
echo '{
  "topicType": "OFFER",
  "offerCouponCode": "SAVE20",
  "offerRedeemUrl": "https://example.com",
  "offerTerms": "Valid until March 31"
}'

Create Your Post

Schedule a Google My Business post with your content, post type, and optional CTA button. Posts appear on your Business Profile in Google Search and Maps.

Post Creation

postiz posts:create \
  -c "Spring sale is here! 20% off all items this weekend." \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "topicType": "OFFER",
    "callToActionType": "GET_OFFER",
    "callToActionUrl": "https://example.com/sale",
    "offerCouponCode": "SPRING20",
    "offerRedeemUrl": "https://example.com/redeem",
    "offerTerms": "Valid March 1-3, 2025"
  }' \
  -i "gmb-id"

Google My Business Settings Reference

Every Google My Business post accepts these platform-specific settings via the --settings flag.

Field	Type	Required	Description
`__type`	string	Yes	Must be "gmb"
`topicType`	string	No	Post type: STANDARD, EVENT, or OFFER
`callToActionType`	string	No	CTA button: NONE, BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP, GET_OFFER, CALL
`callToActionUrl`	string	No	URL for the call-to-action button
`eventTitle`	string	No	Event name (required when topicType is EVENT)
`eventStartDate`	string	No	Event start date in YYYY-MM-DD format
`eventEndDate`	string	No	Event end date in YYYY-MM-DD format
`eventStartTime`	string	No	Event start time in HH:MM format
`eventEndTime`	string	No	Event end time in HH:MM format
`offerCouponCode`	string	No	Coupon code for offer posts
`offerRedeemUrl`	string	No	URL where customers can redeem the offer
`offerTerms`	string	No	Terms and conditions for the offer

Common Configurations

Copy-paste these settings for common Google My Business posting scenarios.

Standard Update with Learn More CTA

settings.json

{
  "topicType": "STANDARD",
  "callToActionType": "LEARN_MORE",
  "callToActionUrl": "https://example.com/about"
}

Event Post with Full Details

settings.json

{
  "topicType": "EVENT",
  "eventTitle": "Weekend Workshop: Getting Started",
  "eventStartDate": "2025-03-15",
  "eventEndDate": "2025-03-16",
  "eventStartTime": "10:00",
  "eventEndTime": "16:00",
  "callToActionType": "BOOK",
  "callToActionUrl": "https://example.com/book"
}

Offer with Coupon Code

settings.json

{
  "topicType": "OFFER",
  "callToActionType": "GET_OFFER",
  "callToActionUrl": "https://example.com/deal",
  "offerCouponCode": "SAVE20",
  "offerRedeemUrl": "https://example.com/redeem",
  "offerTerms": "Valid for new customers only. Expires March 31, 2025."
}

Simple Update with Call Button

settings.json

{
  "topicType": "STANDARD",
  "callToActionType": "CALL"
}

What is nanoclaw?

nanoclaw is a lightweight, container-based alternative to nanoclaw by Qwibit AI. It connects to WhatsApp, Telegram, Slack, Discord, and Gmail, features memory and scheduled jobs, and runs on Anthropic's Agents SDK.

📦

Container-Based

nanoclaw runs in containers for easy deployment and isolation. Spin up your social media automation agent in seconds with Docker.

💬

Multi-Platform Chat

Connect to WhatsApp, Telegram, Slack, Discord, and Gmail. Message nanoclaw from wherever you already communicate.

🧠

Memory & Context

Schedule recurring tasks with cron jobs. nanoclaw can post your Google My Business updates on a schedule without you having to ask each time.

How Postiz Works with nanoclaw

When you install Postiz Agent globally, nanoclaw automatically discovers it by reading the bundled SKILL.md file. This file tells nanoclaw what commands are available, what environment variables are needed, and how to compose Google My Business posts with the right settings.

✓Install Postiz skill with npx skills add gitroomhq/postiz-agent
✓nanoclaw reads the SKILL.md and learns all Postiz commands
✓POSTIZ_API_KEY must be set in environment
✓Skills are loaded on-demand, keeping the agent context clean
✓Runs on Anthropic's Agents SDK for reliable execution

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# nanoclaw discovers Postiz through
# its skill system
nanoclaw skills list

Google My Business Posting with nanoclaw

Message nanoclaw from any platform — it reads the Postiz skill, discovers your Google My Business integration, and handles the entire posting workflow autonomously.

🐳

From Any Chat App

Message nanoclaw from WhatsApp, Telegram...

Send a message to nanoclaw from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your GMB account via Postiz, creates the post with the right type and CTA, and publishes it.

nanoclaw

You: Post to Google My Business about our new
  feature launch, schedule for tomorrow
  at 9am

nanoclaw: On it! Here's my plan:
  1. Found your Google My Business integration
  2. Composing your post
  3. Scheduling for tomorrow 9:00 AM

  Done! Your post is scheduled.
  Post ID: abc-123

🐳

Scheduled & Proactive

nanoclaw supports scheduled jobs ou...

nanoclaw supports cron-based heartbeat tasks. Set up a recurring job that posts weekly business updates, promotes upcoming events, or shares rotating offers — no manual trigger needed.

nanoclaw.json (scheduled job)

{
  "scheduled_jobs": [
    {
      "cron": "0 9 * * 1-5",
      "prompt": "Check ~/content/posts
  for new .txt files. For each one,
  read the content and schedule a
  post to Google My Business for today
  at noon. Move posted files
  to ~/content/published."
    }
  ]
}

Why nanoclaw + Postiz for Google My Business

nanoclaw makes Postiz a natural fit for your Google My Business workflow. The agent discovers all available commands and autonomously chains them together.

✓Message from WhatsApp or Telegram to post to Google My Business — no terminal needed
✓Container-based — easy to deploy, isolate, and scale
✓Built-in memory remembers your content preferences
✓Scheduled jobs for hands-free daily posting
✓Cross-post to Google My Business + other platforms in a single conversation
✓Runs on Anthropic's Agents SDK — reliable and extensible

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including GMB
metadata:
  nanoclaw:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# GMB Settings
topicType, callToActionType,
callToActionUrl, eventTitle,
eventStartDate, eventEndDate,
eventStartTime, eventEndTime,
offerCouponCode, offerRedeemUrl,
offerTerms

Also Works with Claude Code

Postiz Agent works as a CLI tool with any AI agent that can execute shell commands — including Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the SKILL.md file to learn all available Postiz commands, then autonomously discovers your GMB integration, determines the right post type and CTA settings, and publishes the update.

Claude Code

> Create a Google My Business event post
  for our grand opening on March 15th
  from 10am to 6pm, with a Book CTA

Claude will automatically run:
  postiz integrations:list
  postiz posts:create \
    -c "Join us for our Grand Opening!" \
    -s "2025-03-14T09:00:00Z" \
    --settings '{
      "topicType":"EVENT",
      "eventTitle":"Grand Opening",
      "eventStartDate":"2025-03-15",
      "eventEndDate":"2025-03-15",
      "eventStartTime":"10:00",
      "eventEndTime":"18:00",
      "callToActionType":"BOOK",
      "callToActionUrl":
        "https://example.com/book"}' \
    -i "gmb-id"

Google My Business + Other Platforms

Schedule the same content to Google My Business and other platforms in a single command. Each platform gets its own settings.

Terminal

# Post to Google My Business and Facebook simultaneously
postiz posts:create \
  -c "Spring sale! 20% off everything this weekend. Visit us today!" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "topicType": "OFFER",
    "callToActionType": "GET_OFFER",
    "callToActionUrl": "https://example.com/sale",
    "offerCouponCode": "SPRING20",
    "offerRedeemUrl": "https://example.com/redeem",
    "offerTerms": "Valid March 1-3 only"
  }' \
  -i "gmb-id,facebook-id"

# Batch schedule weekly business updates
for week in 1 2 3 4; do
  postiz posts:create \
    -c "Week $week update: New arrivals in store!" \
    -s "2025-03-0${week}T10:00:00Z" \
    --settings '{"topicType":"STANDARD","callToActionType":"LEARN_MORE","callToActionUrl":"https://example.com/new"}' \
    -i "gmb-id"
done

Start posting to Google My Business

Install Postiz Agent and automate your Google My Business presence with AI-powered scheduling, events, and offers.

Get Started

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Start for $0

Open-source social media scheduling tool

Proudly open-source ❤️