Bitrix24 API Docs — Claude Code Plugin

Plugin para Claude Code que fornece acesso completo a documentacao da API REST do Bitrix24, permitindo consultar qualquer metodo, entidade ou padrao de integracao diretamente durante o desenvolvimento.

Numeros

Instalacao

O Claude Code instala plugins via marketplaces. Voce precisa primeiro registrar um marketplace local que contenha o plugin.

Passo 1 — Criar o marketplace local (so na primeira vez)

Crie uma pasta para o marketplace (ou use uma existente):

mkdir -p /caminho/para/meu-marketplace/.claude-plugin
mkdir -p /caminho/para/meu-marketplace/plugins

Crie o arquivo /caminho/para/meu-marketplace/.claude-plugin/marketplace.json:

{
  "name": "local-plugins",
  "owner": { "name": "seu-nome" },
  "plugins": [
    {
      "name": "bitrix24-api-docs",
      "source": "./plugins/bitrix24-api-docs",
      "description": "Bitrix24 REST API documentation reference",
      "version": "1.0.0"
    }
  ]
}

Crie um symlink do plugin dentro da pasta plugins/:

ln -s /caminho/real/para/bitrix24docsclaudeskill /caminho/para/meu-marketplace/plugins/bitrix24-api-docs

Passo 2 — Registrar o marketplace

claude plugin marketplace add /caminho/para/meu-marketplace

Passo 3 — Instalar o plugin

claude plugin install bitrix24-api-docs@local-plugins

Verificar instalacao

claude plugin list

Voce deve ver bitrix24-api-docs@local-plugins com status enabled.

Remover

claude plugin uninstall bitrix24-api-docs@local-plugins

Como funciona

Apos instalado, o plugin ativa automaticamente quando voce menciona termos relacionados ao Bitrix24 em qualquer conversa com o Claude Code:

• Nomes de metodos: crm.lead.add, crm.deal.list, bizproc.workflow.start
• Entidades: "leads", "contacts", "deals", "companies", "quotes"
• Termos tecnicos: "bitrix24", "bitrix", "BX24", "webhook", "placement"

O Claude vai consultar os arquivos de documentacao, encontrar a informacao relevante e responder com exemplos de codigo, parametros e referencias.

Exemplos de perguntas que o plugin responde

"Como criar um lead no Bitrix24 via API?"
"Quais campos o crm.deal.add aceita?"
"Como configurar OAuth no Bitrix24?"
"Qual a diferenca entre crm.item.add e crm.lead.add?"
"Como usar webhooks com o Bitrix24?"
"Me mostra um exemplo de crm.contact.list com filtros"
"A API de invoices esta deprecated? Qual a alternativa?"

Estrutura do projeto

bitrix24docsclaudeskill/
├── .claude-plugin/
│   └── plugin.json             # Manifesto do plugin
├── skills/
│   └── bitrix24-api.md         # Skill com instrucoes de navegacao
├── docs/                       # Documentacao completa (53 arquivos .md + 1 .json)
│   ├── _index.md               # Indice geral com links para todos os arquivos
│   ├── _manifest.json          # Metadados estruturados (metodos por arquivo)
│   ├── 00-overview.md          # Visao geral da API
│   ├── 01-getting-started.md   # Primeiros passos
│   ├── api-crm-*.md            # Referencia das APIs CRM
│   ├── api-*.md                # Outras APIs (bizproc, events, widgets, etc.)
│   ├── tutorials-*.md          # Tutoriais passo a passo
│   ├── settings-*.md           # Configuracao e autenticacao
│   ├── sdk-bx24-js.md          # SDK JavaScript
│   └── ...
├── CLAUDE.md                   # Instrucoes para uso local (sem plugin)
├── split_docs.py               # Script que gerou os docs a partir da fonte
└── README.md                   # Este arquivo

Mapa dos arquivos de documentacao

Primeiros passos

CRM — Entidades principais

CRM — API Universal

CRM — Timeline e Atividades

CRM — Recursos de suporte

CRM — APIs deprecadas

Outras APIs

Configuracao e autenticacao

Tutoriais

Convencao de nomes dos arquivos

Formato dos arquivos

Cada arquivo markdown segue esta estrutura:

---
title: "Titulo do arquivo"
description: "Descricao do conteudo"
methods:
  - crm.lead.add
  - crm.lead.delete
  - crm.lead.get
  - crm.lead.list
  - crm.lead.update
pages: 36
---
# Titulo

> Descricao | **N paginas** | Source: apidocs.bitrix24.com

[conteudo da documentacao]

O frontmatter YAML permite busca programatica por metodo. O arquivo _manifest.json contem os mesmos metadados em formato JSON para acesso via scripts.

Uso sem plugin (modo local)

Se preferir usar sem instalar como plugin, basta abrir o diretorio no Claude Code:

cd /caminho/para/bitrix24docsclaudeskill
claude

O CLAUDE.md na raiz do projeto instrui o Claude a navegar os docs automaticamente.

Atualizando a documentacao

O script split_docs.py foi usado para gerar os arquivos a partir da documentacao oficial. Para atualizar:

1. Obtenha a documentacao atualizada de apidocs.bitrix24.com
2. Execute o script de split para regenerar os arquivos em docs/
3. Verifique se novos arquivos foram criados e atualize skills/bitrix24-api.md se necessario

Notas tecnicas

• Idioma da documentacao: Ingles (traduzido dos docs oficiais do Bitrix24)
• API recomendada: crm.item.* (universal) e a abordagem moderna para novas integracoes
• APIs deprecadas: arquivos com prefixo api-crm-outdated-* contem APIs antigas ainda usadas por codigo legado
• Sem dependencias: o plugin e composto apenas de arquivos markdown, nao requer runtime