pinch-to-post

# 🦞 Pinch to Post `v3.1.0` **Your WordPress site just got claws.** The only WordPress skill you'll ever need. 50+ features. Zero admin panels. Just tell me what you want. > **Keywords:** WordPress, WooCommerce, REST API, WP-CLI, blog automation, content management, ecommerce, posts, pages, media, comments, SEO, Yoast, RankMath, inventory, orders, coupons, bulk operations, multi-site, Gutenberg, publishing ## ⚡ Watch This ``` You: "Create a post about sustainable coffee farming" Bot: Done. Draft #1247 created. Want me to add a featured image? You: "Publish all my drafts from this week" Bot: Published 8 posts. Here are the links... You: "Approve the good comments, spam the bots" Bot: Approved 12, marked 47 as spam. Your comment section is clean. ``` No clicking. No admin panels. No friction. ## 🏆 Why Pinch to Post? | Task | Manual (WP Admin) | With Pinch to Post | |------|-------------------|-------------------| | Create 10 posts | 15-20 minutes | 30 seconds | | Update inventory on 50 products | 45 minutes | 1 minute | | Moderate 100 comments | 20 minutes | 10 seconds | | Check content health on 5 posts | 30 minutes | 15 seconds | | Export all posts to markdown | Hours | 5 seconds | **Time saved per week:** 2-4 hours. **Sanity saved:** Immeasurable. ## 🆕 What's New in v3.0 - **Markdown to Gutenberg** — Write markdown, publish as blocks - **Content Health Scores** — Know if your post is ready before you publish - **Social Cross-Posting** — Twitter, LinkedIn, Mastodon in one command - **Content Calendar** — See your whole publishing schedule - **Bulk Operations** — Mass publish, delete, approve - **Multi-Site Management** — Control all your sites from one place ## 💬 What People Are Saying > *"I used to spend my Sunday mornings moderating comments. Now I just say 'clean up the comments' and go make pancakes."* > *"We manage 12 WordPress sites. This turned a full-time job into a 10-minute daily check-in."* > *"I didn't know I needed this until I had it. Now I can't go back."* ## 📊 Performance Tested and optimized for: - Sites with **50,000+ posts** - WooCommerce stores with **10,000+ products** - Media libraries with **100,000+ files** Rate limiting built-in. Won't hammer your server. ## Quick Setup (60 Seconds) ### Step 1: Get Your Password WordPress Admin → Users → Profile → Application Passwords → Add New → Copy it ### Step 2: Configure Me ```json { "skills": { "entries": { "pinch-to-post": { "enabled": true, "env": { "WP_SITE_URL": "https://your-site.com", "WP_USERNAME": "admin", "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx" } } } } } ``` ### Step 3: There Is No Step 3 You're done. Go publish something. ## Running Multiple Sites? You Overachiever. ```json { "env": { "WP_DEFAULT_SITE": "blog", "WP_SITE_BLOG_URL": "https://blog.example.com", "WP_SITE_BLOG_USER": "admin", "WP_SITE_BLOG_PASS": "xxxx xxxx xxxx", "WP_SITE_SHOP_URL": "https://shop.example.com", "WP_SITE_SHOP_USER": "admin", "WP_SITE_SHOP_PASS": "yyyy yyyy yyyy", "WP_SITE_DOCS_URL": "https://docs.example.com", "WP_SITE_DOCS_USER": "editor", "WP_SITE_DOCS_PASS": "zzzz zzzz zzzz" } } ``` Now say "list posts on the shop site" and feel like a wizard. ## Got WooCommerce? Even Better. ```json { "env": { "WC_CONSUMER_KEY": "ck_xxxxxxxxxxxxxxxx", "WC_CONSUMER_SECRET": "cs_xxxxxxxxxxxxxxxx" } } ``` Products, orders, inventory, coupons, sales reports. All yours. ## Want Social Cross-Posting? (Fancy!) ```json { "env": { "TWITTER_API_KEY": "...", "TWITTER_API_SECRET": "...", "TWITTER_ACCESS_TOKEN": "...", "TWITTER_ACCESS_SECRET": "...", "LINKEDIN_ACCESS_TOKEN": "...", "MASTODON_INSTANCE": "https://mastodon.social", "MASTODON_ACCESS_TOKEN": "..." } } ``` One post. Three platforms. Zero extra work. # The Feature Feast 🍽️ Everything below is what I can do. It's a lot. Grab a snack. ## Posts & Pages The bread and butter. The peanut butter and jelly. The... you get it. ### Create a Post ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/posts" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "title": "Post Title", "content": "<!-- wp:paragraph --><p>Your brilliant words here</p><!-- /wp:paragraph -->", "excerpt": "Brief summary for SEO nerds", "status": "draft", "categories": [1, 5], "tags": [10, 15], "featured_media": 123 }' ``` ### Update a Post ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/posts/{id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{"title": "Even Better Title", "status": "publish"}' ``` ### Delete a Post (Goodbye, Old Friend) ```bash # Soft delete (trash) curl -X DELETE "${WP_SITE_URL}/wp-json/wp/v2/posts/{id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" # Hard delete (gone forever) curl -X DELETE "${WP_SITE_URL}/wp-json/wp/v2/posts/{id}?force=true" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" ``` ### Find Your Posts ```bash # Recent stuff curl -s "${WP_SITE_URL}/wp-json/wp/v2/posts?per_page=20&status=any" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" # Search (where did I put that post about llamas?) curl -s "${WP_SITE_URL}/wp-json/wp/v2/posts?search=llamas" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" # By category curl -s "${WP_SITE_URL}/wp-json/wp/v2/posts?categories=5" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" # By date (time travelers welcome) curl -s "${WP_SITE_URL}/wp-json/wp/v2/posts?after=2026-01-01T00:00:00&before=2026-01-31T23:59:59" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" ``` ### Schedule a Post (Future You Will Thank You) ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/posts" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "title": "This Post Is From The Future", "content": "Scheduled content, so fancy", "status": "future", "date": "2026-02-15T10:00:00" }' ``` ### Pages Too! ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/pages" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "title": "About Us (We're Pretty Great)", "content": "Page content here", "status": "publish", "template": "templates/full-width.php" }' ``` ## Media Management Pictures! Videos! PDFs! All the things! ### Upload an Image ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/media" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Disposition: attachment; filename=masterpiece.jpg" \ -H "Content-Type: image/jpeg" \ --data-binary @/path/to/masterpiece.jpg ``` ### Add Alt Text (Because Accessibility Matters) ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/media/${MEDIA_ID}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "title": "Hero Image", "alt_text": "A majestic llama wearing sunglasses", "caption": "Living its best life" }' ``` ### Set Featured Image ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/posts/{post_id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{"featured_media": 456}' ``` ## Categories & Tags Organize your chaos. ### List Categories ```bash curl -s "${WP_SITE_URL}/wp-json/wp/v2/categories?per_page=100&hide_empty=false" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" ``` ### Create a Category ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/categories" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{"name": "Hot Takes", "slug": "hot-takes", "description": "Opinions nobody asked for"}' ``` ### Tags Work the Same Way ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/tags" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{"name": "must-read", "slug": "must-read"}' ``` ## Comments The good, the bad, and the spammy. ### See Pending Comments ```bash curl -s "${WP_SITE_URL}/wp-json/wp/v2/comments?status=hold" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" ``` ### Approve a Comment ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/comments/{id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{"status": "approved"}' ``` ### Mark as Spam (Begone, Bot!) ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/comments/{id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{"status": "spam"}' ``` ### Reply to a Comment (Be Nice) ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/comments" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "post": {post_id}, "parent": {comment_id}, "content": "Thanks for reading! You rock." }' ``` ### Bulk Approve Everything (YOLO Mode) ```bash for id in $(curl -s "${WP_SITE_URL}/wp-json/wp/v2/comments?status=hold&per_page=100" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" | jq -r '.[].id'); do curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/comments/${id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{"status": "approved"}' done ``` ## WooCommerce 🛒 Ka-ching! Let's make some money. ### Products ```bash # List 'em curl -s "${WP_SITE_URL}/wp-json/wc/v3/products?per_page=20" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" # Create one curl -X POST "${WP_SITE_URL}/wp-json/wc/v3/products" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" \ -H "Content-Type: application/json" \ -d '{ "name": "Fancy Widget", "type": "simple", "regular_price": "49.99", "sale_price": "39.99", "description": "It does widget things. Really well.", "sku": "WIDGET-001", "manage_stock": true, "stock_quantity": 100 }' # Update stock (sold a bunch!) curl -X PUT "${WP_SITE_URL}/wp-json/wc/v3/products/{id}" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" \ -H "Content-Type: application/json" \ -d '{"stock_quantity": 50}' ``` ### Orders ```bash # Recent orders curl -s "${WP_SITE_URL}/wp-json/wc/v3/orders?per_page=20" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" # Mark as shipped curl -X PUT "${WP_SITE_URL}/wp-json/wc/v3/orders/{id}" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" \ -H "Content-Type: application/json" \ -d '{"status": "completed"}' # Add tracking note curl -X POST "${WP_SITE_URL}/wp-json/wc/v3/orders/{id}/notes" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" \ -H "Content-Type: application/json" \ -d '{"note": "Shipped via FedEx #123456", "customer_note": true}' ``` ### Coupons (Everyone Loves a Deal) ```bash curl -X POST "${WP_SITE_URL}/wp-json/wc/v3/coupons" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" \ -H "Content-Type: application/json" \ -d '{ "code": "SAVE20", "discount_type": "percent", "amount": "20", "individual_use": true, "usage_limit": 100, "date_expires": "2026-12-31T23:59:59" }' ``` ### Sales Reports (Show Me The Money) ```bash # Monthly summary curl -s "${WP_SITE_URL}/wp-json/wc/v3/reports/sales?period=month" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" # Top sellers curl -s "${WP_SITE_URL}/wp-json/wc/v3/reports/top_sellers?period=month" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" ``` ### Low Stock Alert ```bash curl -s "${WP_SITE_URL}/wp-json/wc/v3/products?stock_status=lowstock" \ -u "${WC_CONSUMER_KEY}:${WC_CONSUMER_SECRET}" ``` ## SEO Integration Because what good is content nobody can find? ### Yoast SEO ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/posts/{id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "meta": { "_yoast_wpseo_title": "SEO Title | Your Site", "_yoast_wpseo_metadesc": "A compelling description that makes people click (150-160 chars)", "_yoast_wpseo_focuskw": "your main keyword" } }' ``` ### RankMath ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/posts/{id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "meta": { "rank_math_title": "SEO Title", "rank_math_description": "Meta description", "rank_math_focus_keyword": "main keyword" } }' ``` ## Markdown to Gutenberg ✨ Write like a developer. Publish like a designer. Just write your content in markdown and I'll convert it to proper Gutenberg blocks: | Markdown | Becomes | |----------|---------| | `# Heading` | H1 block | | `## Heading` | H2 block | | `Paragraph` | Paragraph block | | `- List item` | List block | | `> Quote` | Quote block | | `**bold**` | Strong tag | | `*italic*` | Em tag | | `---` | Separator block | ```bash # Create post from markdown file ./wp-rest.sh create-post-markdown "My Amazing Post" content.md draft ``` ## Content Health Score 💪 Is your post actually good? Let's find out. ```bash ./wp-rest.sh health-check 123 ``` **What I Check:** - Word count (300+ recommended) - Title length (50-60 chars is the sweet spot) - Excerpt/meta description present - Featured image set - H2 headings for structure - Images in content - Alt text on images - Internal links **Sample Output:** ``` === Content Health Score === Post: How to Train Your Dragon ✅ Word count: 1,247 ✅ Title length: 24 chars ⚠️ Missing excerpt ✅ Featured image: Set ✅ Headings: 4 H2 tags ⚠️ No internal links === SCORE: 75/100 === 🟡 Good, but could be improved. ``` ## Social Media Cross-Posting 📱 One click. All platforms. ### Twitter/X ```bash # Single post post_to_twitter "Check out our latest blog post!" "https://your-site.com/post" # Generate a thread from long content create_twitter_thread 123 ``` ### LinkedIn ```bash post_to_linkedin "New article: AI Trends for 2026" "https://your-site.com/ai-trends" "urn:li:person:YOUR_ID" ``` ### Mastodon ```bash post_to_mastodon "Fresh content just dropped!" "https://your-site.com/post" ``` ## Content Calendar 📅 See your whole publishing schedule at a glance. ```bash ./wp-rest.sh calendar 2026-02 ``` **Output:** ``` === Content Calendar: 2026-02 === 📗 Published: 2026-02-01 - Welcome to February 2026-02-05 - Product Launch Announcement 📅 Scheduled: 2026-02-10 - Valentine's Day Guide 2026-02-20 - Industry Trends Report 📝 Drafts: 456 - Untitled masterpiece 789 - Ideas for later ``` ## Advanced Custom Fields For the power users with custom post types and complex data. ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/posts/{id}" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "acf": { "event_date": "2026-03-15", "event_location": "San Francisco", "event_price": 99.99, "speakers": [ {"name": "Jane Doe", "bio": "Expert in things"}, {"name": "John Smith", "bio": "Knows stuff"} ] } }' ``` ## Multilingual Support Parlez-vous WordPress? ### WPML ```bash curl -X POST "${WP_SITE_URL}/wp-json/wp/v2/posts" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" \ -H "Content-Type: application/json" \ -d '{ "title": "Título en Español", "content": "Contenido traducido", "lang": "es", "translation_of": 123 }' ``` ### Polylang ```bash curl -s "${WP_SITE_URL}/wp-json/pll/v1/languages" \ -u "${WP_USERNAME}:${WP_APP_PASSWORD}" ``` ## Site Operations 🔧 Keep your site running smooth. ### Health Check ```bash ./wp-rest.sh site-health ``` ``` === Site Health === REST API: ✅ OK Auth: ✅ OK Response: 0.342s ``` ### Content Stats ```bash ./wp-rest.sh stats ``` ``` === Content Statistics === Posts (publish): 142 Posts (draft): 23 Posts (pending): 5 Posts (future): 8 Pages: 15 Media: 892 Comments: 1,247 ``` ### Backup Everything ```bash ./wp-rest.sh backup ./my-backups ``` Creates timestamped JSON files for posts, pages, categories, and tags. ### Export to Markdown ```bash ./wp-rest.sh export-markdown ./markdown-archive ``` Perfect for migrating or archiving your content. ## Bulk Operations 🚀 When you need to do ALL THE THINGS. ### Publish Every Draft ```bash ./wp-rest.sh bulk-publish ``` ### Delete Old Posts ```bash ./wp-rest.sh bulk-delete-old 2024-01-01 ``` ### Approve All Comments ```bash ./wp-rest.sh bulk-approve-comments ``` ## AI-Powered Workflows 🤖 Ask Clawdbot to help with these: - "Write a blog post about sustainable fashion with 3 sections" - "Generate 10 headline variations for my post" - "Create a meta description for this content" - "Analyze this post for SEO improvements" - "Suggest categories for these draft posts" - "Summarize this article in 3 bullet points" - "Translate this title to Spanish, French, and German" ## Content Templates Pre-built structures for common content types. ### Blog Post ```json { "title": "{{title}}", "content": "<!-- wp:paragraph -->\n<p>{{intro}}</p>\n<!-- /wp:paragraph -->\n\n<!-- wp:heading -->\n<h2>{{section_1}}</h2>\n<!-- /wp:heading -->\n\n...", "status": "draft" } ``` ### Product Announcement ```json { "title": "Introducing {{product}}", "content": "Hero image, features list, pricing, CTA button..." } ``` ### Event ```json { "title": "{{event_name}}", "content": "Date, time, location, agenda, registration button..." } ``` ### How-To Guide ```json { "title": "How to {{task}}", "content": "Requirements, step-by-step instructions, tips..." } ``` ## WP-CLI Reference For local installs or SSH access. ```bash # Posts wp post create --post_title="Title" --post_status="draft" wp post list --post_type=post --format=table wp post delete {id} --force # Media wp media import /path/to/image.jpg --title="Title" # Database wp db export backup.sql wp db optimize wp search-replace 'old' 'new' --dry-run # Cache wp cache flush wp transient delete --expired # Users wp user list wp user create bob bob@email.com --role=editor ``` ## Error Codes (When Things Go Wrong) | Code | What It Means | What To Do | |------|---------------|------------| | 401 | "Who are you?" | Check username/password | | 403 | "Not allowed" | User needs more permissions | | 404 | "Can't find it" | Check the URL or ID | | 400 | "Bad request" | Check your JSON syntax | | 500 | "Server broke" | Check server logs, pray | ## Pro Tips 🎯 1. **Draft first, publish second** — Review before going live 2. **Use jq** — Parse JSON like a boss: `curl ... | jq '.id'` 3. **Test with dry-run** — For WP-CLI operations 4. **Back up before bulk ops** — Always. ALWAYS. 5. **Check permissions** — Make sure your user role can do the thing 6. **Use excerpts** — Better for SEO and archive pages 7. **Optimize images before upload** — Faster site = happy visitors 8. **Set alt text** — Accessibility matters (and SEO likes it too) 9. **Schedule content** — Consistent publishing beats random bursts 10. **Watch rate limits** — Shared hosting can be... sensitive ## ❓ FAQ **Does this work with WordPress.com?** Only Business/eCommerce plans (they have REST API access). Self-hosted WordPress works perfectly. **What about custom post types?** Yes! Any post type registered with the REST API works automatically. **Will this break my site?** No. Everything uses the official WordPress REST API—the same system the block editor uses. **Do I need to install a plugin?** Nope. WordPress has REST API built-in since version 4.7. **What permissions does my user need?** Administrator for full access, Editor for content, Author for their own posts. **Can I use this with WP Engine / Kinsta / Flywheel?** Yes. Works with any host that hasn't disabled the REST API (almost none do). **What about multisite (WordPress Network)?** Yes! Set up each subsite as a separate site in your config. ## 🔧 Troubleshooting ``` Not working? │ ▼ ┌─────────────────────────────┐ │ Check Application Password │ │ (regenerate if needed) │ └──────────────┬──────────────┘ │ ▼ Still broken? │ ▼ ┌─────────────────────────────┐ │ Check user role has │ │ required capabilities │ └──────────────┬──────────────┘ │ ▼ Still broken? │ ▼ ┌─────────────────────────────┐ │ Check REST API is enabled │ │ (visit /wp-json/ in browser)│ └──────────────┬──────────────┘ │ ▼ Still broken? │ ▼ ┌─────────────────────────────┐ │ Check server error logs │ └─────────────────────────────┘ ``` **Quick Fixes:** - **401 errors:** Password wrong or expired. Regenerate it. - **403 errors:** User lacks permission. Try an admin account. - **404 errors:** Wrong site URL or REST API disabled by a plugin. - **500 errors:** Server issue. Check hosting error logs. *Built with 🦞 and mass quantities of caffeine.* *Made for people who'd rather talk to their sites than click through them.*