suparank 1.2.7 → 1.2.9

package/README.md

@@ -1,224 +1,11 @@
-# Suparank MCP
+# Writer MCP
 
-AI-powered SEO content creation for your blog. Works with Claude Desktop, Cursor, and ChatGPT via the Model Context Protocol (MCP).
+A Model Context Protocol (MCP) server for AI-powered writing assistance.
 
-## Quick Start
+## Overview
 
-```bash
-npx suparank
-```
+This project provides an MCP server that enables AI agents to assist with various writing tasks.
 
-Follow the setup wizard to connect your Suparank account.
+## Getting Started
 
-## What is Suparank?
-
-Suparank is a SaaS platform that helps you create SEO-optimized blog content using AI. This MCP (Model Context Protocol) client connects your AI assistant (Claude, Cursor, ChatGPT) to the Suparank platform.
-
-**Features:**
-- Keyword research and SEO strategy
-- AI-powered content writing with your brand voice
-- Automatic image generation (fal.ai, wiro.ai, Gemini)
-- One-click publishing to WordPress and Ghost
-- Webhook integrations (Make, n8n, Zapier, Slack)
-
-## Installation
-
-### Option 1: npx (Recommended)
-
-No installation needed. Just run:
-
-```bash
-npx suparank
-```
-
-### Option 2: Global Install
-
-```bash
-npm install -g suparank
-suparank
-```
-
-## Setup
-
-1. **Create a Suparank account** at [suparank.io](https://suparank.io)
-
-2. **Create a project** in the dashboard
-
-3. **Get your API key** from Settings > API Keys
-
-4. **Run setup:**
-   ```bash
-   npx suparank setup
-   ```
-
-5. **Add to your AI client:**
-
-   **Claude Desktop** (`~/.config/claude/claude_desktop_config.json`):
-   ```json
-   {
-     "mcpServers": {
-       "suparank": {
-         "command": "npx",
-         "args": ["suparank"]
-       }
-     }
-   }
-   ```
-
-   **Cursor** (MCP settings):
-   ```json
-   {
-     "mcpServers": {
-       "suparank": {
-         "command": "npx",
-         "args": ["suparank"]
-       }
-     }
-   }
-   ```
-
-6. **Start creating content!**
-
-   Just tell your AI: "Create a blog post about [your topic]"
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `npx suparank` | Run MCP server (or setup if first time) |
-| `npx suparank setup` | Run setup wizard |
-| `npx suparank credentials` | Configure local integrations |
-| `npx suparank test` | Test API connection |
-| `npx suparank session` | View current session state |
-| `npx suparank clear` | Clear session state |
-| `npx suparank help` | Show help |
-
-## Local Integrations
-
-Configure local credentials for additional features:
-
-```bash
-npx suparank credentials
-```
-
-### Image Generation
-
-Generate AI images for your blog posts:
-
-- **fal.ai** - Fast, high quality (recommended)
-- **wiro.ai** - Google Imagen via API
-- **Gemini** - Google AI directly
-
-### WordPress Publishing
-
-Publish directly to your WordPress site:
-
-1. Install the [Suparank Connector plugin](https://suparank.io/wordpress-plugin)
-2. Get the secret key from plugin settings
-3. Add to credentials
-
-### Ghost CMS Publishing
-
-Publish directly to your Ghost blog:
-
-1. Go to Ghost Admin > Settings > Integrations
-2. Create a custom integration
-3. Copy the Admin API key
-4. Add to credentials
-
-### Webhooks
-
-Send notifications when content is published:
-
-- Slack
-- Make.com
-- n8n
-- Zapier
-
-## Configuration Files
-
-All configuration is stored in `~/.suparank/`:
-
-```
-~/.suparank/
-├── config.json        # API key and project settings
-├── credentials.json   # Local integrations (WordPress, Ghost, etc.)
-├── session.json       # Current workflow state
-└── content/           # Saved articles
-```
-
-## Available Tools
-
-When connected to your AI assistant, Suparank provides these tools:
-
-### SEO Research
-- `keyword_research` - Keyword analysis and competitive research
-- `seo_strategy` - Create SEO strategy and content briefs
-- `topical_map` - Design pillar-cluster content architecture
-- `content_calendar` - Plan editorial calendar
-
-### Content Creation
-- `content_write` - Write SEO-optimized articles
-- `image_prompt` - Create AI image generation prompts
-- `generate_image` - Generate images (requires credentials)
-
-### SEO Optimization
-- `internal_links` - Develop internal linking strategy
-- `schema_generate` - Create JSON-LD structured data
-- `geo_optimize` - Optimize for AI search engines (GEO)
-- `quality_check` - Pre-publish quality assurance
-
-### Workflow
-- `create_content` - Main entry point (orchestrates full workflow)
-- `save_content` - Save content to session
-- `publish_content` - Publish to configured CMS
-- `get_session` - View current session state
-
-### Publishing
-- `publish_wordpress` - Direct WordPress publishing
-- `publish_ghost` - Direct Ghost CMS publishing
-- `send_webhook` - Send to automation platforms
-
-## Example Workflow
-
-1. **Tell your AI what you want:**
-   ```
-   "Create a blog post about React hooks best practices"
-   ```
-
-2. **Suparank will:**
-   - Research keywords
-   - Create content outline
-   - Write the article (following your brand voice)
-   - Generate cover image
-   - Publish to your CMS
-
-3. **Review and publish** from your CMS dashboard
-
-## Troubleshooting
-
-### "Connection failed"
-
-- Check your API key is valid
-- Ensure your project slug is correct
-- Verify internet connection
-
-### "No credentials configured"
-
-Run `npx suparank credentials` to set up local integrations.
-
-### MCP not connecting
-
-1. Restart your AI client
-2. Check the MCP config path is correct
-3. Ensure Node.js 18+ is installed
-
-## Support
-
-- **Documentation:** [suparank.io/docs](https://suparank.io/docs)
-- **Issues:** [GitHub Issues](https://github.com/Suparank/Suparank-MCP/issues)
-- **Email:** hello@suparank.io
-
-## License
-
-MIT License - see [LICENSE](LICENSE) for details.
+More documentation coming soon.

package/bin/suparank.js

@@ -22,7 +22,7 @@ const CONFIG_FILE = path.join(SUPARANK_DIR, 'config.json')
 const CREDENTIALS_FILE = path.join(SUPARANK_DIR, 'credentials.json')
 const SESSION_FILE = path.join(SUPARANK_DIR, 'session.json')
 
-// Colors for terminal output
+// Colors for terminal output (only used in interactive commands)
 const colors = {
   reset: '\x1b[0m',
   bright: '\x1b[1m',
@@ -34,14 +34,27 @@ const colors = {
   cyan: '\x1b[36m'
 }
 
+// Check if running in MCP mode (no command argument = MCP server)
+const isMCPMode = !process.argv[2] || !['setup', 'test', 'session', 'clear', 'help', '--help', '-h'].includes(process.argv[2])
+
 function log(message, color = 'reset') {
-  console.log(`${colors[color]}${message}${colors.reset}`)
+  // In MCP mode, use stderr to avoid breaking JSON protocol
+  // In interactive mode (setup, test, etc), use stdout for user-friendly output
+  if (isMCPMode) {
+    console.error(`[suparank] ${message}`)
+  } else {
+    console.log(`${colors[color]}${message}${colors.reset}`)
+  }
 }
 
 function logHeader(message) {
-  console.log()
-  log(`=== ${message} ===`, 'bright')
-  console.log()
+  if (isMCPMode) {
+    console.error(`[suparank] === ${message} ===`)
+  } else {
+    console.log()
+    log(`=== ${message} ===`, 'bright')
+    console.log()
+  }
 }
 
 function ensureDir() {
@@ -335,10 +348,9 @@ function runMCP() {
   const config = loadConfig()
 
   if (!config) {
-    log('No configuration found. Running setup...', 'yellow')
-    console.log()
-    runSetup()
-    return
+    // No config - exit with error (user needs to run setup first)
+    console.error('[suparank] No configuration found. Run: npx suparank setup')
+    process.exit(1)
   }
 
   // Find the MCP client script (modular version)
@@ -359,13 +371,15 @@ function runMCP() {
   }
 
   if (!mcpClientPath) {
-    log('Error: mcp-client not found', 'red')
+    console.error('[suparank] Error: mcp-client not found')
     process.exit(1)
   }
 
   // Launch MCP client with config
+  // Use 'pipe' for stdin/stdout to properly handle MCP protocol
+  // stderr is inherited for logging
   const child = spawn('node', [mcpClientPath, config.project_slug, config.api_key], {
-    stdio: 'inherit',
+    stdio: ['inherit', 'inherit', 'inherit'],
     env: {
       ...process.env,
       SUPARANK_API_URL: config.api_url
@@ -373,7 +387,7 @@ function runMCP() {
   })
 
   child.on('error', (err) => {
-    console.error('Failed to start MCP client:', err.message)
+    console.error('[suparank] Failed to start MCP client:', err.message)
     process.exit(1)
   })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "suparank",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "description": "AI-powered SEO content creation MCP - generate and publish optimized blog posts with your AI assistant",
   "type": "module",
   "bin": {