> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin de Claude Code

> Instala el plugin de Ayrshare para Claude Code para publicar, programar y analizar publicaciones sociales desde tu editor — con validación previa a la publicación, un aviso de confirmación antes de publicar, redacción con el tono de la marca y lectura de analíticas.

El plugin de Ayrshare para Claude Code integra la configuración del [MCP Server](/additional/mcp-action-server), un comando de configuración, agentes, skills y un hook de seguridad. Con él instalado, puedes publicar posts, obtener historial y analíticas, gestionar perfiles y más — directamente desde Claude Code. Antes de que algo se publique, el agente valida cada post contra las reglas de la red objetivo y te pide confirmación, evitando rechazos innecesarios. El historial de publicaciones está disponible para replicar el tono de una marca, y las analíticas pueden leerse para orientar el siguiente post.

El plugin es de código abierto. Consulta el repositorio para ver el detalle: [ayrshare/ayrshare-social-media-api-claude-plugin](https://github.com/ayrshare/ayrshare-social-media-api-claude-plugin).

## Instalación

<Steps>
  <Step title="Añade el marketplace (una vez)">
    ```bash theme={"system"}
    claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin
    ```
  </Step>

  <Step title="Instala el plugin">
    ```bash theme={"system"}
    claude plugin install ayrshare@ayrshare
    ```
  </Step>
</Steps>

### Alcances de instalación

| Alcance              | Dónde aplica                                          |
| -------------------- | ----------------------------------------------------- |
| Global (por defecto) | Todos los proyectos en esta máquina.                  |
| `--scope local`      | Proyecto actual, no se sube a git.                    |
| `--scope project`    | Proyecto actual, se sube y se comparte con tu equipo. |

<Note>
  La CLI de Claude Code llama al alcance global `--scope user`.
</Note>

## Credenciales

Proporciona tu API key de Ayrshare por cualquiera de estas vías:

<ul class="custom-bullets">
  <li>Ejecuta `/ayrshare:setup` para configurar o rotar la clave.</li>
  <li>Define la variable de entorno `AYRSHARE_API_KEY`.</li>
</ul>

El `.mcp.json` que trae el plugin ya declara la cabecera `Authorization` junto con las cabeceras opcionales `Profile-Key` y BYOK de X, cada una con un valor por defecto vacío (`${VAR:-}`), así que activas una cabecera simplemente definiendo su variable de entorno (Claude Code sustituye los valores al iniciar). Para dirigir todas las llamadas a un sub-perfil, define `AYRSHARE_PROFILE_KEY` (mediante `/ayrshare:setup` o el bloque `env` de tu `settings.json`) y reinicia Claude Code; la cabecera `Profile-Key` incluida la lleva, y queda vacía (tratada como no proporcionada) cuando no está definida. Para dirigir una única llamada a un sub-perfil en su lugar, pasa un argumento `profileKey` en la herramienta (no hace falta cambiar la configuración). No necesitas editar el `.mcp.json` incluido, y no deberías, porque `claude plugin update` lo sobrescribe.

<Warning>
  El servidor MCP se inicializa al inicio de la sesión. **Reinicia Claude Code** después de instalar el plugin o cambiar tu clave.
</Warning>

### Credenciales BYO de X/Twitter

Publicar en X/Twitter requiere tus propias credenciales de X Developer App (el mandato de claves BYO de X, vigente desde el 31 de marzo de 2026; consulta el [API Overview](/apis/overview#xtwitter-byo-credentials)). El `.mcp.json` incluido ya declara ambas cabeceras BYOK de X con valores por defecto vacíos, junto con `Authorization` y `Profile-Key`:

```json theme={"system"}
"headers": {
  "Authorization": "Bearer ${AYRSHARE_API_KEY}",
  "Profile-Key": "${AYRSHARE_PROFILE_KEY:-}",
  "X-Twitter-OAuth1-Api-Key": "${X_TWITTER_OAUTH1_API_KEY:-}",
  "X-Twitter-OAuth1-Api-Secret": "${X_TWITTER_OAUTH1_API_SECRET:-}"
}
```

Así que solo defines las variables de entorno correspondientes (`X_TWITTER_OAUTH1_API_KEY`, `X_TWITTER_OAUTH1_API_SECRET`) mediante `/ayrshare:setup` o el bloque `env` de tu `settings.json`, y luego **reinicias Claude Code**; no editas el `.mcp.json` incluido (se sobrescribe con `claude plugin update`). Define **ambas** o ninguna: con ninguna definida, una llamada a X/Twitter devuelve el error `419` (`x_credentials_required`); con solo una definida devuelve el error `400`. Es un par de claves por cuenta de Ayrshare, enviado en cada solicitud dirigida a X (el mismo par para todos los sub-perfiles).

<Note>
  ¿Prefieres una conexión directa en lugar del plugin? Las mismas cabeceras BYO se pueden pasar con `claude mcp add --header` — consulta [Conexión y configuración → Credenciales BYO de X/Twitter](/additional/mcp-action-connect#xtwitter-byo-credentials).
</Note>

## Qué incluye

### Comando

<ul class="custom-bullets">
  <li>`/ayrshare:setup` — configurar o rotar la API key de Ayrshare.</li>
</ul>

### Agentes

<ul class="custom-bullets">
  <li>`social-manager`: publica, programa y analiza contenido en todas las plataformas.</li>
  <li>`profile-manager`: crea y lista perfiles y genera URLs de vinculación social JWT para los perfiles de los clientes bajo una cuenta Business.</li>
  <li>`insights-analyst`: reportes de solo lectura. Extrae métricas e historial de publicaciones y resume el rendimiento; nunca publica, comenta, envía mensajes ni modifica nada.</li>
</ul>

### Skills

| Skill                        | Propósito                                                     |
| ---------------------------- | ------------------------------------------------------------- |
| `getting-started`            | Orientar y conectar en el primer uso.                         |
| `post`                       | Crear, validar, actualizar y reintentar publicaciones.        |
| `history`                    | Obtener el historial de publicaciones y de plataforma.        |
| `analytics`                  | Extraer analíticas por post y a nivel de cuenta.              |
| `comments`                   | Leer, añadir y responder comentarios.                         |
| `messages`                   | Leer y enviar mensajes directos y configurar auto-respuestas. |
| `profiles`                   | Crear y listar sub-perfiles.                                  |
| `media`                      | Validar que las URLs de medios sean accesibles.               |
| `generate`                   | Redactar el texto del post con IA y recomendar hashtags.      |
| `webhooks`                   | Registrar, dar de baja y listar webhooks.                     |
| `errors`                     | Decodificar códigos de error de Ayrshare.                     |
| `draft-in-brand-voice`       | Redactar posts con un tono de marca consistente.              |
| `plan-and-schedule-campaign` | Planificar y programar una campaña de varios posts.           |

### Hook de confirmación

Un hook `PreToolUse` pide confirmación antes de cualquier acción de publicación o envío. Cubre exactamente estas 7 herramientas:

<ul class="custom-bullets">
  <li>`create_post`</li>
  <li>`update_post`</li>
  <li>`retry_post`</li>
  <li>`add_comment`</li>
  <li>`reply_comment`</li>
  <li>`send_message`</li>
  <li>`set_auto_response`</li>
</ul>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿El plugin valida las publicaciones antes de publicar?">
    Sí. El plugin ejecuta `validate_post` para simular tu contenido contra las reglas de cada red — longitud, formato y requisitos de medios — antes de publicar, de modo que detectas rechazos evitables de antemano.
  </Accordion>

  <Accordion title="¿Pregunta antes de publicar en mis cuentas reales?">
    Sí. Un hook de confirmación `PreToolUse` te pide aprobar antes de cualquier acción de publicación o envío: `create_post`, `update_post`, `retry_post`, `add_comment`, `reply_comment`, `send_message` y `set_auto_response`.
  </Accordion>

  <Accordion title="¿El plugin puede replicar el tono de mi marca?">
    Sí. La skill `draft-in-brand-voice` lee tu historial de publicaciones para redactar nuevo copy con un tono de marca consistente. Solo produce borradores — nada se publica sin tu confirmación.
  </Accordion>

  <Accordion title="¿Puedo leer analíticas para orientar el siguiente post?">
    Sí. Las herramientas de analítica devuelven métricas por post y a nivel de cuenta, de modo que puedes leer los resultados y dejar que guíen tu próxima publicación.
  </Accordion>

  <Accordion title="¿Qué necesito para usar el plugin?">
    Una API key de Ayrshare (una clave del plan Business para perfiles y sub-perfiles) y Claude Code. Configura la clave con `/ayrshare:setup` o la variable de entorno `AYRSHARE_API_KEY`, y reinicia Claude Code.
  </Accordion>

  <Accordion title="¿Publicar en X/Twitter requiere una configuración adicional?">
    Sí. X/Twitter requiere tus propias credenciales OAuth 1.0a, añadidas como dos cabeceras de conexión (`X-Twitter-OAuth1-Api-Key` y `X-Twitter-OAuth1-Api-Secret`). Consulta [Credenciales BYO de X/Twitter](#xtwitter-byo-credentials) arriba.
  </Accordion>
</AccordionGroup>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Conexión y configuración" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Autenticación, direccionamiento de perfiles y credenciales BYO.
  </Card>

  <Card title="Catálogo de herramientas" icon="list" href="/additional/mcp-action-tools" horizontal>
    Las 27 herramientas agrupadas por dominio, con alcance y propósito.
  </Card>
</CardGroup>