← Back to Clawdbot Tools
Clawdbot Tools by @bennewton999

blackops-center

Control your BlackOps Center sites from Clawdbot

New
Source Code

BlackOps Center Skill

Control your BlackOps Center sites from Clawdbot. Create, publish, and manage blog posts via API.

Setup

  1. Generate an API token in BlackOps Center:

    • Go to Settings → Browser Extension
    • Copy your Personal Access Token

  2. Configure the skill:

    cd ~/.clawdbot/skills/blackops-center
cp config.example.yaml config.yaml
# Edit config.yaml and paste your token

Configuration

Create config.yaml:

api_token: "your-token-here"
base_url: "https://blackopscenter.com"  # or your custom domain

Available Commands

All commands use the blackops-center CLI wrapper.

List Sites

Show all sites you have access to:

blackops-center list-sites

Returns JSON with your sites and which one is active for this token.

List Posts

List posts for your site:

# List all posts
blackops-center list-posts

# List only published posts
blackops-center list-posts --status published

# List only drafts
blackops-center list-posts --status draft

# Limit results
blackops-center list-posts --limit 10

Get a Post

Get full details of a specific post:

blackops-center get-post <post-id>

Create a Post

Create a new draft post:

blackops-center create-post \
  --title "My Post Title" \
  --content "Post content in markdown" \
  --excerpt "Optional excerpt" \
  --tags "tag1,tag2,tag3"

All posts are created as drafts by default.

Update a Post

Update an existing post:

# Update title
blackops-center update-post <post-id> --title "New Title"

# Update content
blackops-center update-post <post-id> --content "New content"

# Publish a draft
blackops-center update-post <post-id> --status published

# Unpublish (back to draft)
blackops-center update-post <post-id> --status draft

You can combine multiple flags to update multiple fields at once.

Delete a Post

blackops-center delete-post <post-id>

Usage from Clawdbot

When you invoke this skill from a Clawdbot session, you can use natural language:

User: "Create a blog post about AI agents titled 'The Future of Automation'"

Assistant will:

  1. Extract title and content from your message
  2. Run blackops-center create-post --title "..." --content "..."
  3. Return the post ID and preview URL

User: "Publish post abc123"

Assistant will:

  1. Run blackops-center update-post abc123 --status published
  2. Confirm publication and provide the live URL

User: "Show me my recent draft posts"

Assistant will:

  1. Run blackops-center list-posts --status draft --limit 10
  2. Format the results in a readable way

API Details

This skill uses the BlackOps Center Extension API (/api/ext/*):

  • GET /api/ext/sites - List sites
  • GET /api/ext/posts - List posts
  • POST /api/ext/posts - Create post
  • GET /api/ext/posts/:id - Get post
  • PUT /api/ext/posts/:id - Update post
  • DELETE /api/ext/posts/:id - Delete post

All requests require Authorization: Bearer <token> header.

Error Handling

  • 401 Unauthorized: Token is invalid or revoked. Generate a new token in BlackOps Center.
  • 404 Site not found: The domain associated with your token doesn't exist.
  • 404 Post not found: Post ID doesn't exist or belongs to a different site.
  • 400 Bad Request: Missing required fields (e.g., title, content for create).

Examples

Create and publish workflow

# Create draft
POST_ID=$(blackops-center create-post \
  --title "My Post" \
  --content "# My Post\n\nGreat content here." | jq -r '.post.id')

# Review, edit if needed...

# Publish when ready
blackops-center update-post "$POST_ID" --status published

Bulk operations

# Get all draft posts
DRAFTS=$(blackops-center list-posts --status draft)

# Publish all drafts (careful!)
echo "$DRAFTS" | jq -r '.posts[].id' | while read id; do
  blackops-center update-post "$id" --status published
done

Troubleshooting

"Unauthorized" error:

  • Verify your token in config.yaml
  • Check token hasn't been revoked in BlackOps Center
  • Generate a new token if needed

"Site not found":

  • Each token is tied to a specific site domain
  • If you need to manage multiple sites, generate separate tokens for each

Command not found:

  • Make sure bin/ is executable: chmod +x ~/.clawdbot/skills/blackops-center/bin/*
  • Skill should be installed via ClawdHub or symlinked to ~/.clawdbot/skills/

Development

Test the API directly with curl:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://blackopscenter.com/api/ext/posts

Support