К основному содержанию
скилл CX Codex

google-docs · acedatacloud — скилл для Claude Code: что делает и как установить

Позволяет читать, создавать и редактировать документы Google Docs через официальный REST API с помощью curl и jq.

Apache-2.0 175 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill google-docs -a claude-code
Открыть на GitHub

Что делает google-docs

Скилл подключает агент к Google Docs REST API v1 через curl и утилиту jq. Он извлекает чистый текст из древовидной структуры блоков документа, создаёт новые файлы в корневом каталоге Google Drive и правит содержимое через метод batchUpdate. Идентификатор документа берётся из пути ссылки или через поиск.

Для авторизации инструмент использует OAuth bearer-токен из переменной окружения $GOOGLE_DOCS_TOKEN. По умолчанию коннектор выдаёт права только на чтение documents.readonly. Запись требует расширенного разрешения documents, иначе запросы завершаются ошибкой 403 PERMISSION_DENIED.

Правки текста опираются на посимвольные индексы документа: каждая вставка смещает позиции последующих символов. Из-за этого серии изменений нужно выполнять с конца к началу или пересчитывать индексы между вызовами.

Какие задачи решает

  • читать текст из документов Google Docs без открытия браузера
  • создавать пустые документы с заданным названием напрямую из консоли
  • вставлять текст по числовому индексу позиции
  • заменять заполнители и переменные по всему тексту документа

Примеры запросов агенту

  • Прочитай содержимое документа с идентификатором DOC_ID
  • Создай новый Google Doc с названием «План спринта»
  • Замени все совпадения маркера {{name}} на Алексей в документе DOC_ID

Как установить google-docs

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill google-docs -a claude-code

2Вручную: положить файлы

~/.claude/skills/google-docs/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/google-docs/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о google-docs

Как установить google-docs в Claude Code?

Выполните команду npx skills add AceDataCloud/Skills --skill google-docs -a claude-code. Файл манифеста сохранится по пути ~/.claude/skills/google-docs/SKILL.md.

Что делает этот скилл?

Он отправляет запросы к REST API Google Docs через curl, позволяя парсить структуру документа, добавлять текст и проводить пакетные правки.

Почему редактирование завершается ошибкой 403 PERMISSION_DENIED?

По умолчанию подключение получает скоуп documents.readonly. Для внесения изменений при установке необходимо выдать полные права documents.

Исходный текст

SKILL.md · Apache-2.0
---
name: google-docs
description: Read and edit Google Docs via the Docs v1 REST API. Use when the user mentions a Google Doc, reading a document's text, creating a doc, inserting or replacing text, or exporting a doc's content.
when_to_use: |
  Trigger when the user wants to read a Google Doc's content, create a
  new doc, or insert / replace text in one. The connector grants
  `documents.readonly` by default; the user opts in to `documents`
  (read + write) at install — confirm before edits. Find the doc id
  from a Drive URL or a google-drive search.
connections: [google/docs]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

Drive **Google Docs** via `curl + jq`. The user's OAuth bearer token is in
`$GOOGLE_DOCS_TOKEN`; every call needs `Authorization: Bearer
$GOOGLE_DOCS_TOKEN`. Base URL: `https://docs.googleapis.com/v1/documents`. The
token carries `documents.readonly` (+ identity); writes need `documents`.

Failures are `{"error":{"code","message","status"}}` — show verbatim. `401` =
re-install. `403 PERMISSION_DENIED` on a write = read-only scope.

The doc id is the `…/document/d/<ID>/edit` segment of the URL.

```bash
D="https://docs.googleapis.com/v1/documents"; AUTH="Authorization: Bearer $GOOGLE_DOCS_TOKEN"
# Read the document. The body is a tree of structural elements; pull plain text:
curl -sS -H "$AUTH" "$D/DOC_ID" \
  | jq -r '.title, ([.body.content[]?.paragraph?.elements[]?.textRun?.content] | join(""))'
```

## Create & edit

```bash
# Create an empty doc
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"title":"Meeting notes 2026-06-21"}' "$D" | jq '{documentId, title}'

# Insert text at the start (index 1) via batchUpdate (confirm first)
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"requests":[{"insertText":{"location":{"index":1},"text":"Hello\n"}}]}' \
  "$D/DOC_ID:batchUpdate" | jq '.documentId'

# Replace all occurrences of a placeholder
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"requests":[{"replaceAllText":{"containsText":{"text":"{{name}}","matchCase":true},"replaceText":"Alex"}}]}' \
  "$D/DOC_ID:batchUpdate" | jq '.replies'
```

## Gotchas

- The document model is **index-based**: text edits target character indices, and
  every insert shifts later indices — for multiple inserts, apply them
  back-to-front or recompute indices between calls.
- To get clean Markdown/plain text, walk `body.content[].paragraph.elements[]
  .textRun.content` (the jq above). Tables / lists need deeper traversal.
- Creating a doc puts it in the user's Drive root; use the `google-drive` skill to
  move/share it.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →

Сначала — google-docs от других авторов.

google-docs sanjay3290 Скилл google-docs создаёт документы, ищет их по названию, читает текст и правит содержимое прямо из чата с агентом. Нужен аккаунт Google Workspace. CX Codex +1 564установок google-docs официальный OpenAI Создаёт, редактирует и проверяет Google Docs, сохраняя структуру, шаблоны и ссылки. Работает с документами, содержащими таблицы, вкладки и поля. CX Codex GP ChatGPT +1 22установок google-docs membrane Позволяет агенту читать и менять документы Google Docs через Membrane CLI. Создаёт документы, заменяет текст и вставляет таблицы. CX Codex +1 203установок Google Docs googledocs MCP-сервер ищет документы Google Drive, читает и редактирует Google Docs, а также работает с комментариями. Подключите его, чтобы поручать эти действия агенту. CX Codex +1 1 024установок FGAC.ai: Multiple Gmail Accounts, Google Sheets & Docs fgac-ai FGAC.ai: Multiple Gmail Accounts, Google Sheets & Docs — MCP-сервер для Claude Code с правилами доступа к Google. Даёт агенту почту и таблицы, но не весь Drive. CX Codex +1 google-drive официальный OpenAI Скилл для Codex и ChatGPT, который объединяет работу с Google Drive, Docs, Sheets и Slides через один интерфейс. CX Codex GP ChatGPT +1 25установок google odyssey4me Подключает Google Workspace через CLI-инструмент gog. CX Codex +1 844установок recipe-create-doc-from-template официальный googleworkspace Скилл recipe-create-doc-from-template для Claude Code копирует шаблон Google Docs, вставляет текст и настраивает доступ коллегам через CLI. Создаёт типовые отчёты и брифы. CX Codex +1 31 800установок Google Workspace aaronsb MCP-сервер Google Workspace подключает агента к сервисам Google: почте, календарям, файлам на Диске и таблицам. Позволяет управлять несколькими аккаунтами прямо из диалога. CX Codex +1 ★ 200звёзд репо

Из того же набора67

Весь набор →
google-ads Запрашивает через Google Ads API кампании, группы объявлений, ключевые слова и расходы. Получает данные о кликах и конверсиях для отчётов. CX Codex +1 177установок vercel Скилл проверяет сборки, читает логи ошибок и управляет доменами на Vercel через REST API прямо из чата с агентом. CX Codex +1 176установок bilibili Скилл читает статистику статей в Bilibili и помогает публиковать новые через ваш аккаунт. Для работы нужны cookies входа. CX Codex +1 175установок figma Читает файлы Figma через REST API: дерево документа, отдельные ноды, рендер в PNG и комментарии. Запускается при переводе макета в код. CX Codex +1 175установок personal-wechat Скилл personal-wechat подключает Claude Code к личному WeChat через собственный сервер Wisdom: агент читает чаты и контакты, а перед отправкой сообщений запрашивает подтверждение. CX Codex +1 162установок tencent-docs Скилл открывает агенту доступ к вашему аккаунту Tencent Docs через открытый API: создавать файлы, читать содержимое, искать по диску и разбирать папки. CX Codex +1 157установок acedatacloud Управляет аккаунтом AceDataCloud через management API: балансом, API-ключами, заказами и каталогом сервисов. Подключается к задачам через Claude Code и другие IDE. CX Codex +1 127установок webextrator Скилл webextrator для Claude Code извлекает содержимое веб-страниц через API AceDataCloud. Запускается для получения HTML после рендеринга или структурированных данных по URL. CX Codex +1 107установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой