OSP Marketing Tools for Node.js

Um conjunto de ferramentas para criação, otimização e posicionamento de conteúdo de marketing técnico, baseado nas metodologias da Open Strategy Partners.

GitHub
5
Experimente este MCPPatrocinado

Documentação

OSP Marketing Tools for Node.js

Model Context Protocol Language License

Um conjunto abrangente de ferramentas para criação, otimização e posicionamento de conteúdo técnico de marketing, baseado nas metodologias comprovadas da Open Strategy Partners. Esta é uma implementação em TypeScript do servidor MCP para OSP Marketing Tools.

Por que a implementação em TypeScript?

Esta implementação em TypeScript/Node.js oferece vantagens significativas em relação à versão original em Python:

  • Instalação simplificada: Menos dependências e processo de configuração mais direto
  • Compatibilidade entre plataformas: Funciona perfeitamente no Windows sem os problemas comuns de dependências do Python
  • Desempenho mais rápido: Node.js geralmente oferece melhor desempenho para esse tipo de servidor
  • Ecossistema JavaScript moderno: Aproveita o robusto ecossistema de pacotes npm
  • Integração mais fácil: Mais simples de integrar com aplicações web e outras ferramentas JavaScript
  • Menor uso de recursos: Geralmente requer menos memória e recursos do sistema

Perfeito para quem deseja usar o OSP Marketing Tools sem lidar com dependências Python, ambientes virtuais ou problemas de compatibilidade.

Recursos

1. OSP Product Value Map Generator

Gere mapas de valor de produto OSP estruturados que comunicam efetivamente o valor e o posicionamento do seu produto. Esta ferramenta fornece:

  • Criação e refinamento de taglines estratégicas
  • Declarações de posicionamento nas dimensões de mercado, técnica, UX e negócios
  • Desenvolvimento de personas com papéis, desafios e necessidades
  • Documentação de casos de valor com benefícios, desafios e soluções claros
  • Categorização de recursos em uma hierarquia estruturada

2. OSP Meta Information Generator

Crie metadados otimizados para conteúdo web com posicionamento adequado de palavras-chave e estrutura amigável para SEO. Esta ferramenta entrega:

  • Títulos de artigos (H1) com posicionamento estratégico de palavras-chave
  • Títulos meta otimizados para busca (50-60 caracteres)
  • Descrições meta com propostas de valor atraentes (155-160 caracteres)
  • Slugs de URL amigáveis para SEO
  • Análise e otimização da intenção de busca
  • Considerações de exibição em dispositivos móveis

3. OSP Content Editing Codes

Aplique os códigos de edição semântica da OSP para uma revisão abrangente de conteúdo. Este sistema fornece:

  • Análise de escopo e estrutura narrativa
  • Melhoria de fluxo e legibilidade
  • Otimização de estilo e fraseado
  • Verificação de escolha de palavras e gramática
  • Validação de precisão técnica
  • Orientação para linguagem inclusiva
  • Feedback construtivo com exemplos de antes/depois

4. OSP Technical Writing Guide

Abordagem sistemática para criar conteúdo técnico de alta qualidade com estrutura narrativa e fluxo adequados. O guia cobre:

  • Princípios de estrutura narrativa e progressão lógica
  • Otimização de fluxo e organização de conteúdo
  • Diretrizes de estilo para clareza e precisão
  • Verificação de precisão técnica
  • Orientação específica por tipo de conteúdo (tutoriais, documentação de referência, documentação de API)
  • Melhores práticas de acessibilidade e internacionalização

5. OSP On-Page SEO Guide

Sistema abrangente para otimizar conteúdo web para mecanismos de busca e experiência do usuário. Este guia inclui:

  • Estratégias de otimização de conteúdo meta
  • Técnicas de aprofundamento de conteúdo
  • Alinhamento da intenção de busca em diferentes tipos de consulta
  • Protocolos de pesquisa e integração de palavras-chave
  • Melhores práticas de links internos
  • Implementação de dados estruturados
  • Estratégias de promoção de conteúdo

Instalação

Pré-requisitos

  • Node.js 18 ou superior
  • npm ou yarn

Configuração

Você pode instalar e usar este pacote de duas maneiras:

Configuração via npm (recomendado)

  1. Instale o pacote globalmente:

Adicione ao seu arquivo de configuração do Claude Desktop (claude_desktop_config.json):

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

Configuração a partir do código-fonte

# 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

Adicione ao seu arquivo de configuração do Claude Desktop (claude_desktop_config.json):

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

Nota para usuários do Windows: Certifique-se de substituir path/to/osp-marketing-tools-mcp pelo caminho real do diretório osp-marketing-tools-mcp no seu computador. Por exemplo, se você clonou o repositório para C:\Users\YourName\Documents\osp-marketing-tools-mcp, a linha args deve ficar assim:

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

Além disso, lembre-se de usar barras invertidas duplas \\ em vez de barras invertidas simples \ no caminho.

Uso

Executando o servidor no modo stdio (para Claude Desktop, Cursor, etc.)

npm start

Executando o servidor no modo HTTP/SSE

npm run start:sse

Isso iniciará um servidor web na porta 3000 (configurável via variável de ambiente PORT) que expõe a API MCP via Server-Sent Events (SSE).

Quando o servidor estiver em execução no modo HTTP/SSE, você pode acessar a interface web em http://localhost:3000/, que fornece uma demonstração interativa das ferramentas disponíveis.

Ferramentas Disponíveis

  • health_check - Verificação do status de saúde do servidor e disponibilidade de recursos
  • get_editing_codes - Documentação dos Códigos de Edição OSP e protocolo de uso para revisão semântica de conteúdo
  • get_writing_guide - Guia de Escrita OSP com princípios para criar conteúdo técnico de alta qualidade
  • get_meta_guide - Gerador de Metainformações OSP para otimização de metadados de conteúdo web
  • get_value_map_positioning_guide - Gerador de Mapa de Valor de Produto OSP para posicionamento eficaz do produto
  • get_on_page_seo_guide - Guia de SEO On-Page OSP para otimização abrangente de conteúdo

Prompts Disponíveis

  • edit-content - Revise o conteúdo usando os códigos de edição OSP para melhorar a qualidade e a clareza
  • generate-meta - Gere metadados otimizados para conteúdo web com posicionamento adequado de palavras-chave
  • generate-value-map - Crie um mapa de valor OSP estruturado para posicionamento do produto
  • apply-writing-guide - Aplique os princípios de escrita OSP para criar conteúdo técnico
  • optimize-seo - Aplique estratégias de SEO on-page para otimizar o conteúdo para busca

Exemplo de Uso

Usando com Claude ou outro LLM

Para usar os códigos de edição OSP para revisar conteúdo, basta enviar este prompt ao Claude (após configurar o 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 gerar um mapa de valor do produto:

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

Usando com Integração Direta via API (SSE)

O servidor fornece um exemplo de cliente JavaScript que demonstra como conectar-se ao servidor MCP usando Server-Sent Events (SSE). Quando você executa o servidor no modo HTTP/SSE, pode acessar a demonstração em http://localhost:3000/.

Aqui está um exemplo simples de como conectar-se ao endpoint SSE programaticamente:

// 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();
}

Desenvolvimento

# Run in development mode (stdio)
npm run dev

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

Estrutura do Projeto

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

Atribuição

Este software é baseado nas metodologias de criação e otimização de conteúdo desenvolvidas pela Open Strategy Partners. Ele implementa suas ferramentas de marketing habilitadas por LLM e estruturas profissionais de criação de conteúdo.

Para mais informações e recursos originais, visite:

  1. O Guia de Escrita e Edição da OSP
  2. Guia de Início Rápido dos Códigos de Edição
  3. Recursos Gratuitos da OSP

Licença

Este software é licenciado sob a licença Attribution-ShareAlike 4.0 International da Creative Commons Corporation ("Creative Commons").