blackops-center

# 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**: ```bash cd ~/.clawdbot/skills/blackops-center cp config.example.yaml config.yaml # Edit config.yaml and paste your token ``` ## Configuration Create `config.yaml`: ```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: ```bash blackops-center list-sites ``` Returns JSON with your sites and which one is active for this token. ### List Posts List posts for your site: ```bash # 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: ```bash blackops-center get-post <post-id> ``` ### Create a Post Create a new draft post: ```bash 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: ```bash # 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 ```bash 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 ```bash # 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 ```bash # 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: ```bash curl -H "Authorization: Bearer YOUR_TOKEN" \ https://blackopscenter.com/api/ext/posts ``` ## Support - BlackOps Center: https://blackopscenter.com - Issues: https://github.com/clawdbot/skills (if published) - Documentation: This file