Automate Google My Business with Paperclip

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 Paperclip

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 Paperclip?

Paperclip is an open-source orchestration framework for building “zero-human companies” by hiring and managing teams of AI agents. It handles content, social media distribution, marketing, dev, QA, and more from a single dashboard.

👥

Agent Teams

Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.

📊

Single Dashboard

Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.

⚙

Orchestration

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

How Postiz Works with Paperclip

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

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz commands to specialized agents in your team
✓Orchestrate multi-step workflows with approval chains
✓Monitor everything from the Paperclip dashboard

Install Postiz

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

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# its tool integration system
# and assigns it to agent teams

Google My Business Posting with Paperclip

Message Paperclip 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

Paperclip assigns specialized agents to ...

Send a message to Paperclip 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.

Paperclip

Content Agent: Drafted a post about
  the feature launch for Google My Business.

Review Agent: Approved with minor
  edits. Ready to publish.

Scheduling Agent: Found Google My Business
  integration via Postiz.
  Scheduled for tomorrow 9:00 AM.

  Post ID: abc-123
  Status: Scheduled

📎

Scheduled & Proactive

Paperclip orchestrates recurring co...

Paperclip 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.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft a Google My Business post
          about trending industry topics"
      - role: reviewer
        task: "Review and polish the
          draft for engagement"
      - role: publisher
        task: "Schedule via Postiz
          for today at noon"

Why Paperclip + Postiz for Google My Business

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

✓Multi-agent teams for quality Google My Business content — draft, review, publish
✓Single dashboard to monitor all social media automation
✓Orchestrated pipelines from content creation to publishing
✓Scheduled pipelines for hands-free daily posting
✓Cross-post to Google My Business + other platforms in a single pipeline
✓Open-source — fully customizable agent workflows

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including GMB
metadata:
  paperclip:
    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 ❤️