Agent Skills
› NeverSight/learn-skills.dev
› blogger
blogger
GitHub通过Blogger API v3管理博客，支持发布、更新、读取文章及列出博客。需先获取blogId，内容须为HTML格式。涉及OAuth认证，遇401需重连，注意API权限开启。
Trigger Scenarios
提及 Blogger 或 blogspot
要求发布博客文章
列出个人博客
更新现有博客文章
Install
npx skills add NeverSight/learn-skills.dev --skill blogger -g -y
SKILL.md
Frontmatter
{
"name": "blogger",
"license": "Apache-2.0",
"metadata": {
"author": "acedatacloud",
"version": "1.0"
},
"connections": [
"google\/blogger"
],
"description": "Publish posts to your Blogger blog and read your blogs \/ posts via the Blogger API v3. Use when the user mentions Blogger, blogspot, publishing a post to their blog, listing their blogs, or updating an existing Blogger post.",
"when_to_use": "Trigger when the user wants to publish a post to their Blogger blog,\nlist their blogs, list \/ read posts on a blog, or update an existing\npost. The connector grants the Blogger scope (read + write); confirm\nbefore publishing publicly (you can insert as a draft first).\n",
"allowed_tools": [
"Bash"
]
}
Call the Blogger API v3 with curl + jq. The user's OAuth bearer token is
in $GOOGLE_BLOGGER_TOKEN; every call needs
Authorization: Bearer $GOOGLE_BLOGGER_TOKEN. Base URL:
https://www.googleapis.com/blogger/v3.
Errors are {"error": {"code": ..., "message": ...}} — show them verbatim.
401 → token expired, re-connect the Blogger connector.
Always start by listing the user's blogs to get a blogId:
curl -sS -H "Authorization: Bearer $GOOGLE_BLOGGER_TOKEN" \
"https://www.googleapis.com/blogger/v3/users/self/blogs" \
| jq '.items[] | {id, name, url}'
Publish a post
Confirm before publishing publicly. Use ?isDraft=true to stage a draft.
BLOG_ID="1234567890"
jq -n --arg t "My title" --arg c "<p>HTML content of the post…</p>" \
'{kind:"blogger#post", title:$t, content:$c, labels:["ai","video"]}' \
| curl -sS -X POST \
"https://www.googleapis.com/blogger/v3/blogs/$BLOG_ID/posts/?isDraft=false" \
-H "Authorization: Bearer $GOOGLE_BLOGGER_TOKEN" \
-H "Content-Type: application/json" \
-d @- \
| jq '{id, url, status}'
content is HTML (not Markdown) — convert Markdown to HTML first
(e.g. with pandoc -f markdown -t html or a simple converter).
- Publish a staged draft:
POST /blogs/{blogId}/posts/{postId}/publish. - Update a post:
PUT /blogs/{blogId}/posts/{postId}with the same shape.
List / read posts
curl -sS -H "Authorization: Bearer $GOOGLE_BLOGGER_TOKEN" \
"https://www.googleapis.com/blogger/v3/blogs/$BLOG_ID/posts?maxResults=20&status=live" \
| jq '.items[] | {id, title, url, published}'
Gotchas
- Enable the Blogger API on the Google Cloud project backing the OAuth
client, or calls 403 with
accessNotConfigured. contentmust be HTML; passing raw Markdown will render literally.- Paginate with
&pageToken=$PAGE_TOKENfrom the previous.nextPageToken.
Version History
- e0220ca Current 2026-07-05 22:53
