Skip to content

quartz-labs-dev/pabal-web-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pabal-web-mcp

MCP (Model Context Protocol) server for bidirectional conversion between ASO (App Store Optimization) and web SEO data.

This library enables seamless reuse of ASO data for web SEO purposes, allowing you to convert ASO metadata directly into web SEO content and vice versa.

한국어 docs

🛠️ MCP Client Installation

Requirements

  • Node.js >= 18
  • MCP client: Cursor, Claude Code, VS Code, Windsurf, etc.

Tip

If you repeatedly do ASO/store tasks, add a client rule like "always use pabal-web-mcp" so the MCP server auto-invokes without typing it every time.

Install in Cursor

Add to ~/.cursor/mcp.json (global) or project .cursor/mcp.json:

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-web-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "pabal-web-mcp"
    }
  }
}
Install in VS Code

Example settings.json MCP section:

"mcp": {
  "servers": {
    "pabal-web-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pabal-web-mcp"]
    }
  }
}

Or if installed globally:

"mcp": {
  "servers": {
    "pabal-web-mcp": {
      "type": "stdio",
      "command": "pabal-web-mcp"
    }
  }
}
Install in Claude Code

[!TIP] See the official Claude Code MCP documentation for detailed configuration options.

Add to Claude Code MCP settings (JSON format):

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-web-mcp"]
    }
  }
}

Or if installed globally (npm install -g pabal-web-mcp):

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "pabal-web-mcp"
    }
  }
}
Install in Windsurf
{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-web-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "pabal-web-mcp"
    }
  }
}

MCP Server

This package includes an MCP server for managing ASO data through Claude or other MCP-compatible clients.

Available Tools

Tool Description
aso-to-public Convert ASO data to public config format
public-to-aso Convert public config to ASO data format
improve-public Improve product locale content with AI suggestions
init-project Initialize a new product project structure

Usage

Importing Types

import type {
  // ASO Types
  AsoData,
  AppStoreAsoData,
  GooglePlayAsoData,

  // Product Types
  ProductConfig,
  ProductLocale,
  LandingPage,
  LandingHero,
  LandingScreenshots,
  LandingFeatures,
  LandingReviews,
  LandingCta,
} from "pabal-web-mcp";

Importing Utilities

import {
  // ASO Converter
  loadAsoFromConfig,

  // Locale Constants
  DEFAULT_LOCALE,
  UNIFIED_LOCALES,

  // Locale Converters
  unifiedToAppStore,
  unifiedToGooglePlay,
  appStoreToUnified,
  googlePlayToUnified,
} from "pabal-web-mcp";

Example: Loading ASO Data

import { loadAsoFromConfig } from "pabal-web-mcp";

const asoData = loadAsoFromConfig("my-app");
console.log(asoData.appStore?.name);
console.log(asoData.googlePlay?.title);

Types Reference

ASO Types

  • AsoData - Combined ASO data for both stores
  • AppStoreAsoData - App Store specific ASO data
  • GooglePlayAsoData - Google Play specific ASO data
  • AppStoreMultilingualAsoData - Multilingual App Store data
  • GooglePlayMultilingualAsoData - Multilingual Google Play data

Product Types

  • ProductConfig - Product configuration
  • ProductLocale - Localized product content
  • LandingPage - Landing page structure
  • AppPageData - Complete app page data

Locale Types

  • UnifiedLocale - Unified locale code (e.g., "en-US", "ko-KR")

Supported Locales

Supports all languages supported by each store.

Unified App Store Google Play
en-US en-US en-US
ko-KR ko ko-KR
ja-JP ja ja-JP
zh-CN zh-Hans zh-CN
zh-TW zh-Hant zh-TW
de-DE de-DE de-DE
fr-FR fr-FR fr-FR
es-ES es-ES es-ES
pt-BR pt-BR pt-BR
... ... ...

License

MIT



🌐 Pabal Web

Want to manage ASO and SEO together? Check out Pabal Web.

Pabal Web

Pabal Web is a Next.js-based web interface that provides a complete solution for unified management of ASO, SEO, Google Search Console indexing, and more.

👉 Visit Pabal Web

About

MCP server for bidirectional conversion between ASO and web SEO data.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published