Save blog post
ps_save_blog_post
Writes a new blog post or edits an existing one.
Ask Claude
„Fix the meta descriptions of the 5 blog posts flagged by the audit.”
Example preview
Post 8 "How to choose garden lamps", language en. meta_description: empty -> 152 characters. meta_title: empty -> "How to choose garden lamps | Guide".
Technical details
Creates or updates a SmartBlog post: title, content, short description, meta title, meta description, categories, status (published or draft). Preview first, logged in the change history, revertible with ps_revert_change. ps_audit_seo points to it as the fix for blog posts. Appears only when the SmartBlog module is detected (ps_get_shop_info reports the blog module).
Parameters
Parameter names are not confirmed in module 0.3.0 yet and may change.
| Name | Type | Required | Description |
|---|---|---|---|
| post_id | integer | no | Existing post ID. Empty creates a new post. |
| title | string | no | Post title. |
| content | string (HTML) | no | Post content. |
| excerpt | string | no | Short description. |
| meta_title | string | no | Meta title. |
| meta_description | string | no | Meta description. |
| category_ids | array of integer | no | Blog categories. |
| active | boolean | no | Published or draft. |
| lang | string | when: shop has more than one active language | ISO code of the language you write in. Required when the shop has more than one active language. Claude writes the content in this language. |
| shop_id | integer | no | Shop ID in a multistore installation. Defaults to the shop in the connector address. IDs are listed by ps_get_shop_info. |
| confirm | boolean | no | false (default) returns a preview and saves nothing. true executes, only after the user approved the preview, together with change_token. |
| change_token | string | when: confirm=true | Token from the preview. Required with confirm=true. Valid 30 minutes, single use, bound to the previewed arguments and data state. |
Limits
Requires SmartBlog. One language per call. Slug changes go through ps_change_url (SmartBlog slugs max 45 characters).
What you see before anything is saved
Claude first calls the tool without confirming it. The module returns a preview (current and new values) and a single-use token valid for 30 minutes. Claude shows you the preview and saves the change only after your yes.
Related tools
- List blog posts ps_list_blog_posts
- Get blog post ps_get_blog_post
- SEO audit ps_audit_seo
- Change URL (slug) ps_change_url
- Revert change ps_revert_change
Last updated: 2026-10-03