blogger — скилл для Claude Code: публикация и установка
Скилл для Claude Code работает с Blogger API v3: публикует записи, читает блоги и посты, обновляет публикации. Управляет блогом из Claude Code.
Apache-2.0 221 установок ★ 17 обновлён 2026-10-25
npx skills add AceDataCloud/Skills --skill blogger -a claude-codeЧто делает blogger
Скилл сначала получает список блогов, чтобы найти blogId, затем вызывает Blogger API v3 через curl и jq. Он умеет публиковать запись, читать посты и обновлять существующую. Запрос на публикацию отправляет запись сразу в открытый доступ; черновик создаётся только по прямой просьбе. После публикации агент сообщает возвращённый URL.
Для запросов нужен OAuth-токен в $GOOGLE_BLOGGER_TOKEN, а Blogger API должен быть включён в Google Cloud-проекте OAuth-клиента. Тело поста передаётся в HTML: сырой Markdown Blogger покажет как текст. Если токен истёк, ответ API будет 401; при пустом токене возможен 403, а без включённого API — ошибка accessNotConfigured.
Установите скилл командой npx skills add AceDataCloud/Skills --skill blogger -a claude-code. Без OAuth-подключения скилл не сможет обращаться к блогу; для чтения постов предусмотрена пагинация через nextPageToken.
Какие задачи решает
- опубликовать запись в Blogger
- найти блоги подключённого аккаунта
- прочитать опубликованные посты
- обновить существующую запись
- превратить Markdown-текст в HTML перед публикацией
Примеры запросов агенту
- Опубликуй эту статью в моём блоге Blogger как запись в открытом доступе.
- Покажи мои блоги и последние опубликованные посты.
- Обнови запись с ID
12345и замени её содержимое на этот HTML.
Как установить blogger
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill blogger -a claude-code2Вручную: положить файлы
~/.claude/skills/blogger/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/blogger/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill blogger -a codex2Вручную: положить файлы
.agents/skills/blogger/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill blogger -a cursor2Вручную: положить файлы
.cursor/skills/blogger/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install AceDataCloud/Skills skills/blogger2Вручную: положить файлы
.github/skills/blogger/SKILL.md1Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill blogger -a gemini-cli2Командой платформы
gemini skills install https://github.com/AceDataCloud/Skills --path skills/bloggerВручную: положить файлы
.devin/skills/blogger/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add AceDataCloud/Skills --skill blogger -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о blogger
Как установить blogger в Claude Code?
Выполните npx skills add AceDataCloud/Skills --skill blogger -a claude-code. Файл скилла находится по пути ~/.claude/skills/blogger/SKILL.md.
Что делает скилл blogger?
Он использует Blogger API v3, чтобы находить блоги аккаунта, публиковать и читать записи, а также обновлять посты. Публикация по запросу сразу становится доступна читателям, если пользователь явно не попросил черновик.
Что нужно для публикации в Blogger?
Нужен OAuth-токен в $GOOGLE_BLOGGER_TOKEN, а Blogger API требуется включить в Google Cloud-проекте OAuth-клиента. Содержимое записи передаётся в HTML, поэтому Markdown нужно предварительно преобразовать.
Исходный текст
SKILL.md · Apache-2.0
---
name: 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,
list their blogs, list / read posts on a blog, or update an existing
post. The connector grants the Blogger scope (read + write). When the
user asks to "publish" / "post" / "发布" / "发出去", publish it LIVE
(isDraft=false) directly — only stage a draft when the user explicitly
asks for a draft or says they want to review it first.
connections: [google/blogger]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
author: acedatacloud
version: "1.0"
---
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`:
```bash
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
When the user asks to publish / post / 发布 / 发出去, publish it **live**
with `?isDraft=false` (the default below) — do NOT silently save a draft
and stop. Only pass `?isDraft=true` when the user explicitly asks for a
draft or to review before going public. After publishing, always report
the returned live `url` back to the user.
```bash
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
```bash
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`.
- A `403 "Method doesn't allow unregistered callers"` means the request
carried no token (empty `$GOOGLE_BLOGGER_TOKEN`) — ask the user to
(re)connect the Blogger connector, don't blame their Google Cloud setup.
- An empty `{"kind":"blogger#blogList"}` (no `items`) means the connected
Google account owns no blog — tell the user to create one at blogger.com
or reconnect with the account that has the blog.
- `content` must be HTML; passing raw Markdown will render literally.
- Paginate with `&pageToken=$PAGE_TOKEN` from the previous `.nextPageToken`.
## Record the output
After you successfully publish and obtain the live result URL, call the built-in
`publish_artifact` tool ONCE so the user can track this deliverable in **My Outputs**:
```
publish_artifact(kind="article", channel="blogger", title="<title>", url="<the REAL returned URL>", status="delivered")
```
Use the real returned URL — never fabricate one. Call it once per published item,
only after delivery is confirmed; skip it (or use `status="failed"`) if publishing failed.
See `_shared/artifacts.md`.
© acedatacloud · Apache-2.0 · AceDataCloud/Skills