OSP Marketing Tools for Node.js

Un conjunto de herramientas para la creación, optimización y posicionamiento de productos de contenido de marketing técnico, basado en las metodologías de Open Strategy Partners.

GitHub

Prueba este MCPPatrocinado

Documentación

OSP Marketing Tools para Node.js

Un conjunto completo de herramientas para la creación de contenido de marketing técnico, optimización y posicionamiento de productos basado en las metodologías probadas de Open Strategy Partners. Esta es una implementación en TypeScript del servidor MCP para OSP Marketing Tools.

¿Por qué una implementación en TypeScript?

Esta implementación en TypeScript/Node.js ofrece ventajas significativas sobre la versión original en Python:

Instalación simplificada: Menos dependencias y un proceso de configuración más directo
Compatibilidad multiplataforma: Funciona sin problemas en Windows sin los problemas comunes de dependencias de Python
Rendimiento más rápido: Node.js normalmente ofrece un mejor rendimiento para este tipo de servidor
Ecosistema JavaScript moderno: Aprovecha el robusto ecosistema de paquetes npm
Integración más fácil: Más sencillo de integrar con aplicaciones web y otras herramientas JavaScript
Menor uso de recursos: Generalmente requiere menos memoria y recursos del sistema

Perfecto para quienes quieren usar OSP Marketing Tools sin lidiar con dependencias de Python, entornos virtuales o problemas de compatibilidad.

Características

1. Generador de Mapas de Valor de Producto OSP

Genera mapas de valor de producto OSP estructurados que comunican eficazmente el valor y posicionamiento de tu producto. Esta herramienta proporciona:

Creación y refinamiento estratégico de eslóganes
Declaraciones de posicionamiento en dimensiones de mercado, técnicas, UX y de negocio
Desarrollo de personas con roles, desafíos y necesidades
Documentación de casos de valor con beneficios, desafíos y soluciones claros
Categorización de características en una jerarquía estructurada

2. Generador de Metainformación OSP

Crea metadatos optimizados para contenido web con una colocación adecuada de palabras clave y una estructura amigable para SEO. Esta herramienta ofrece:

Títulos de artículo (H1) con colocación estratégica de palabras clave
Metatítulos optimizados para búsqueda (50-60 caracteres)
Metadescripciones con propuestas de valor convincentes (155-160 caracteres)
Slugs de URL amigables para SEO
Análisis y optimización de la intención de búsqueda
Consideraciones de visualización móvil

3. Códigos de Edición de Contenido OSP

Aplica los códigos de edición semántica de OSP para una revisión integral del contenido. Este sistema proporciona:

Análisis del alcance y la estructura narrativa
Mejora del flujo y la legibilidad
Optimización del estilo y la redacción
Verificación de la elección de palabras y la gramática
Validación de la precisión técnica
Orientación sobre lenguaje inclusivo
Retroalimentación constructiva con ejemplos de antes/después

4. Guía de Redacción Técnica OSP

Enfoque sistemático para crear contenido técnico de alta calidad con una estructura narrativa y un flujo adecuados. La guía cubre:

Principios de estructura narrativa y progresión lógica
Optimización del flujo y organización del contenido
Pautas de estilo para claridad y precisión
Verificación de la precisión técnica
Orientación específica por tipo de contenido (tutoriales, documentación de referencia, documentación de API)
Mejores prácticas de accesibilidad e internacionalización

5. Guía de SEO On-Page OSP

Sistema integral para optimizar contenido web para motores de búsqueda y experiencia del usuario. Esta guía incluye:

Estrategias de optimización de metacontenido
Técnicas de mejora de la profundidad del contenido
Alineación de la intención de búsqueda en diferentes tipos de consulta
Protocolos de investigación e integración de palabras clave
Mejores prácticas de enlazado interno
Implementación de datos estructurados
Estrategias de promoción de contenido

Instalación

Requisitos previos

Node.js 18 o superior
npm o yarn

Configuración

Puedes instalar y usar este paquete de dos maneras:

Configuración mediante npm (recomendada)

Instala el paquete globalmente:

Añade a tu archivo de configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "ai_think_gate": {
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/osp-marketing-tools-mcp"
      ]
    }
  }
}

Configuración desde el código fuente

# Clone the repository
git clone https://github.com/x51xxx/osp-marketing-tools-mcp.git
cd osp-marketing-tools-mcp

# Install dependencies
npm install

# Build the project
npm run build

Añade a tu archivo de configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "osp_marketing_tools": {
      "command": "node",
      "args": [
        "path/to/osp-marketing-tools-mcp/dist/index.js"
      ]
    }
  }
}

Nota para usuarios de Windows: Asegúrate de reemplazar path/to/osp-marketing-tools-mcp con la ruta real al directorio osp-marketing-tools-mcp en tu computadora. Por ejemplo, si clonaste el repositorio en C:\Users\YourName\Documents\osp-marketing-tools-mcp, la línea args debería verse así:

"args": ["C:\\Users\\YourName\\Documents\\osp-marketing-tools-mcp\\dist\\index.js"]

Además, recuerda usar dobles barras invertidas \\ en lugar de barras invertidas simples \ en la ruta.

Uso

Ejecutar el servidor en modo stdio (para Claude Desktop, Cursor, etc.)

npm start

Ejecutar el servidor en modo HTTP/SSE

npm run start:sse

Esto iniciará un servidor web en el puerto 3000 (configurable mediante la variable de entorno PORT) que expone la API de MCP mediante Server-Sent Events (SSE).

Una vez que el servidor esté ejecutándose en modo HTTP/SSE, puedes acceder a la interfaz web en http://localhost:3000/ que proporciona una demostración interactiva de las herramientas disponibles.

Herramientas Disponibles

health_check - Estado de salud del servidor y verificación de disponibilidad de recursos
get_editing_codes - Documentación de los Códigos de Edición OSP y protocolo de uso para revisión semántica de contenido
get_writing_guide - Guía de Redacción OSP con principios para crear contenido técnico de alta calidad
get_meta_guide - Generador de Metainformación OSP para optimización de metadatos de contenido web
get_value_map_positioning_guide - Generador de Mapas de Valor de Producto OSP para un posicionamiento eficaz del producto
get_on_page_seo_guide - Guía de SEO On-Page OSP para una optimización integral del contenido

Prompts Disponibles

edit-content - Revisar contenido usando los códigos de edición OSP para mejorar la calidad y claridad
generate-meta - Generar metadatos optimizados para contenido web con una colocación adecuada de palabras clave
generate-value-map - Crear un mapa de valor OSP estructurado para el posicionamiento del producto
apply-writing-guide - Aplicar los principios de redacción OSP para crear contenido técnico
optimize-seo - Aplicar estrategias de SEO on-page para optimizar contenido para búsqueda

Ejemplo de Uso

Uso con Claude u otro LLM

Para usar los códigos de edición OSP para revisar contenido, simplemente envía este prompt a Claude (después de configurar el servidor MCP):

Review this technical content using OSP editing codes:

Kubernetes is a container orchestration platform. It handles deploying applications and scaling them as needed. There's lots of things it can do. It's really good. You should use it for your applications to make them more resilient.

Para generar un mapa de valor de producto:

Generate an OSP value map for [Product Name] focusing on [target audience] with the following key features: [list features]

Example:
Generate an OSP value map for CloudDeploy focusing on DevOps engineers with these key features:
- Automated deployment pipeline
- Infrastructure as code support
- Real-time monitoring
- Multi-cloud compatibility

Uso con Integración Directa de API (SSE)

El servidor proporciona un ejemplo de cliente JavaScript que demuestra cómo conectarse al servidor MCP usando Server-Sent Events (SSE). Cuando ejecutes el servidor en modo HTTP/SSE, puedes acceder a la demostración en http://localhost:3000/.

Aquí hay un ejemplo simple de cómo conectarse al endpoint SSE programáticamente:

// Connect to SSE endpoint
const source = new EventSource('http://localhost:3000/sse');
let sessionId;

// Listen for session ID
source.addEventListener('sessionId', (event) => {
    sessionId = JSON.parse(event.data).sessionId;
    console.log(`Connected with session ID: ${sessionId}`);
});

// Listen for tool responses
source.addEventListener('toolResponse', (event) => {
    const response = JSON.parse(event.data);
    console.log('Tool response:', response);
});

// Call a tool
async function callTool(name, args = {}) {
    const response = await fetch(`http://localhost:3000/messages?sessionId=${sessionId}`, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            jsonrpc: '2.0',
            id: Date.now().toString(),
            method: 'tools/call',
            params: {
                name: name,
                arguments: args
            }
        })
    });

    return response.json();
}

Desarrollo

# Run in development mode (stdio)
npm run dev

# Run in development mode (HTTP/SSE)
npm run dev:sse

Estructura del Proyecto

osp-marketing-tools-mcp/
├── prompts/             # Markdown resources from OSP tools
├── public/              # Static web files for HTTP server
│   └── index.html       # SSE client demo interface
├── src/
│   ├── utils/           # Utility functions
│   │   └── contentReader.ts
│   ├── tools/           # MCP tool implementations
│   │   └── index.ts
│   ├── prompts/         # MCP prompt templates
│   │   └── index.ts
│   ├── resources/       # MCP resource implementations
│   │   └── index.ts
│   ├── index.ts         # Main entry point (stdio)
│   └── http.ts          # HTTP/SSE server
├── dist/                # Compiled JavaScript (generated)
├── package.json
└── tsconfig.json

Atribución

Este software se basa en las metodologías de creación y optimización de contenido desarrolladas por Open Strategy Partners. Implementa sus herramientas de marketing habilitadas para LLM y marcos profesionales de creación de contenido.

Para más información y recursos originales, visita:

Licencia

Este software está licenciado bajo la licencia internacional Attribution-ShareAlike 4.0 de Creative Commons Corporation ("Creative Commons").