# Guía de Publicación en Hugging Face

## 📋 Prerrequisitos

1. Cuenta en Hugging Face: https://huggingface.co/join
2. Git instalado
3. Git LFS instalado (opcional pero recomendado)

## 🚀 Método 1: Crear Space Directamente en Hugging Face

### Paso 1: Crear el Space

1. Ve a https://huggingface.co/new-space
2. Configura:
   - **Space name**: `mcp-figma-rest-api` (o el nombre que prefieras)
   - **License**: MIT
   - **Space SDK**: Static
   - **Visibility**: Public

### Paso 2: Clonar y Subir Contenido

```bash
# Clonar el Space vacío
git clone https://huggingface.co/spaces/TU_USUARIO/mcp-figma-rest-api
cd mcp-figma-rest-api

# Copiar el README preparado para Hugging Face
cp ../mcp-figma-comment-summary/README.huggingface.md README.md

# Añadir y publicar
git add README.md
git commit -m "Add Complete Figma REST API MCP Server v2.0.0"
git push
```

### Paso 3: Verificar

Ve a `https://huggingface.co/spaces/TU_USUARIO/mcp-figma-rest-api` y verifica que todo se vea correctamente.

---

## 🔗 Método 2: Sincronizar desde GitHub

### Opción A: Importar Repositorio Existente

1. Ve a https://huggingface.co/new-space
2. Selecciona **"Import from GitHub"**
3. Conecta tu cuenta de GitHub
4. Selecciona tu repositorio `mcp-figma-comment-summary`
5. Hugging Face clonará automáticamente

**IMPORTANTE:** Si usas este método, necesitas renombrar `README.huggingface.md` a `README.md` en tu repositorio de GitHub primero.

### Opción B: Configurar Sincronización Bidireccional

Si quieres mantener GitHub como fuente principal y que Hugging Face se sincronice automáticamente:

```bash
# En tu repositorio local
cd /Users/fran/Documents/IN/Labs/mcp-figma-comment-summary

# Añadir Hugging Face como remote adicional
git remote add huggingface https://huggingface.co/spaces/TU_USUARIO/mcp-figma-rest-api

# Crear una rama específica para Hugging Face (opcional)
git checkout -b huggingface-sync

# Renombrar README para Hugging Face
mv README.md README.github.md
mv README.huggingface.md README.md

# Commit y push a Hugging Face
git add .
git commit -m "Prepare for Hugging Face deployment"
git push huggingface huggingface-sync:main

# Volver a la rama principal
git checkout main
```

---

## 📝 Personalizar la Página de Hugging Face

El archivo `README.huggingface.md` ya tiene los metadatos necesarios en el frontmatter YAML:

```yaml
---
title: Figma REST API MCP Server
emoji: 🎨
colorFrom: purple
colorTo: blue
sdk: static
pinned: false
tags:
  - mcp
  - model-context-protocol
  - figma
  - api
  - design
  - collaboration
  - claude
  - webhooks
  - variables
license: mit
---
```

Puedes personalizar:
- **title**: Nombre que aparece en Hugging Face
- **emoji**: Icono del Space
- **colorFrom/colorTo**: Gradiente del header
- **tags**: Para búsqueda y descubrimiento
- **pinned**: Si quieres que aparezca destacado en tu perfil

---

## 🔍 Verificación Post-Publicación

Después de publicar, verifica:

1. ✅ El README se muestra correctamente
2. ✅ Los 29 endpoints están documentados
3. ✅ Los ejemplos de uso funcionan
4. ✅ Los enlaces a npm y GitHub funcionan
5. ✅ Las instrucciones de instalación son claras

---

## 📦 Actualizar en el Futuro

Cuando publiques actualizaciones:

```bash
# Si usas el método directo
cd mcp-figma-rest-api
# Actualiza README.md con los cambios
git add .
git commit -m "Update to v2.0.1"
git push

# Si sincronizas desde GitHub
git push github main
git push huggingface huggingface-sync:main
```

---

## 🌟 Promoción

Una vez publicado, puedes:

1. Compartir el enlace en:
   - Twitter/X con hashtags #MCP #Figma #Claude
   - Discord de Model Context Protocol
   - Comunidad de Figma

2. Añadir badge en tu README de GitHub:
   ```markdown
   [![Hugging Face](https://img.shields.io/badge/🤗%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/TU_USUARIO/mcp-figma-rest-api)
   ```

3. Enlazar desde tu perfil de npm:
   - Actualiza el `homepage` en `package.json` si quieres que apunte a Hugging Face

---

## ❓ Troubleshooting

### El README no se muestra correctamente
- Verifica que el archivo se llama exactamente `README.md`
- Revisa que el frontmatter YAML esté correcto
- Comprueba que no haya caracteres especiales mal formateados

### Los cambios no se reflejan
- Espera 1-2 minutos (Hugging Face puede tardar en actualizar)
- Haz un hard refresh (Cmd+Shift+R en Mac, Ctrl+Shift+R en Windows)
- Verifica que el push se completó correctamente

### Error de permisos
- Asegúrate de estar autenticado en Hugging Face
- Configura tu token de acceso si es necesario:
  ```bash
  git config credential.helper store
  ```

---

## 📚 Referencias

- [Hugging Face Spaces Documentation](https://huggingface.co/docs/hub/spaces)
- [Hugging Face Git LFS](https://huggingface.co/docs/hub/repositories-getting-started#terminal)
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [Figma REST API Docs](https://developers.figma.com/docs/rest-api/)