pabal-web-mcp 1.4.7 → 1.4.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,109 +1,65 @@
1
1
  # pabal-web-mcp
2
2
 
3
- MCP (Model Context Protocol) server for bidirectional conversion between ASO (App Store Optimization) and web SEO data.
3
+ MCP server for ASO Web SEO data conversion.
4
4
 
5
- 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. **Build your own synced website** based on ASO data from App Store Connect and Google Play Console, keeping your app store listings and web presence perfectly synchronized.
5
+ Build synced websites from App Store Connect and Google Play Console data.
6
6
 
7
- > 💡 **Example**: Check out [labs.quartz.best](https://labs.quartz.best/) to see a live website built with this library, where app store data is automatically synced to create a beautiful, SEO-optimized web presence.
7
+ > 💡 **Example**: [labs.quartz.best](https://labs.quartz.best/)
8
8
 
9
- [![한국어 docs](https://img.shields.io/badge/docs-Korean-green)](./i18n/README.ko.md)
9
+ [![Documentation](https://img.shields.io/badge/docs-English-blue)](https://pabal.quartz.best/docs/en-US/pabal-mcp/README) [![한국어](https://img.shields.io/badge/docs-한국어-green)](https://pabal.quartz.best/docs/ko-KR/pabal-mcp/README)
10
10
 
11
- ## 🛠️ Installation
12
-
13
- ### Requirements
14
-
15
- - Node.js >= 18
16
- - [pabal-mcp](https://github.com/quartz-labs-dev/pabal-mcp) must be installed and configured
17
-
18
- ### Install as Library
19
-
20
- Install this library in your website project:
11
+ ## Installation
21
12
 
22
13
  ```bash
23
14
  npm install pabal-web-mcp
24
- # or
25
- yarn add pabal-web-mcp
26
- # or
27
- pnpm add pabal-web-mcp
28
15
  ```
29
16
 
30
- ## 🔐 Configure Credentials
17
+ **Requirements:** Node.js >= 18, [pabal-mcp](https://github.com/quartz-labs-dev/pabal-mcp)
31
18
 
32
- pabal-web-mcp uses the configuration file from `pabal-mcp`. For detailed credential setup instructions (App Store Connect API keys, Google Play service accounts, etc.), please refer to the [pabal-mcp README](https://github.com/quartz-labs-dev/pabal-mcp?tab=readme-ov-file#-configure-credentials).
19
+ ## MCP Configuration
33
20
 
34
- ### ⚠️ Important: Set dataDir Path
21
+ ```json
22
+ {
23
+ "mcpServers": {
24
+ "pabal-web-mcp": {
25
+ "command": "npx",
26
+ "args": ["-y", "pabal-web-mcp"]
27
+ }
28
+ }
29
+ }
30
+ ```
35
31
 
36
- **You must set `dataDir` in `~/.config/pabal-mcp/config.json` to the absolute path where your `pabal-web` project is stored on your local machine.**
32
+ For keyword research, add `mcp-appstore`:
37
33
 
38
34
  ```json
39
35
  {
40
- "dataDir": "/ABSOLUTE/PATH/TO/pabal-web",
41
- "appStore": {
42
- "issuerId": "xxxx",
43
- "keyId": "xxxx",
44
- "privateKeyPath": "./app-store-key.p8"
45
- },
46
- "googlePlay": {
47
- "serviceAccountKeyPath": "./google-play-service-account.json"
36
+ "mcp-appstore": {
37
+ "command": "node",
38
+ "args": ["/PATH/TO/external-tools/mcp-appstore/server.js"],
39
+ "cwd": "/PATH/TO/external-tools/mcp-appstore"
48
40
  }
49
41
  }
50
42
  ```
51
43
 
52
- Examples:
53
-
54
- - macOS: `"/Users/username/projects/pabal-web"`
55
- - Linux: `"/home/username/projects/pabal-web"`
56
- - Windows: `"C:\\Users\\username\\projects\\pabal-web"`
57
-
58
- ## MCP Server
59
-
60
- This package includes an MCP server for managing ASO data through Claude or other MCP-compatible clients.
61
-
62
- ### Available Tools
63
-
64
- | Tool | Description |
65
- | ------------------ | -------------------------------------------------------- |
66
- | `aso-to-public` | Convert ASO data to public config format |
67
- | `public-to-aso` | Convert public config to ASO data format |
68
- | `keyword-research` | Plan/persist ASO keyword research (.aso/keywordResearch) |
69
- | `improve-public` | Improve product locale content with AI suggestions |
70
- | `init-project` | Initialize a new product project structure |
71
- | `create-blog-html` | Generate static HTML blog posts with BLOG_META headers |
72
-
73
- ### Using external keyword MCP ([appreply-co/mcp-appstore](https://github.com/appreply-co/mcp-appstore))
74
-
75
- 1. Install deps in the existing clone: `cd external-tools/mcp-appstore && npm install`
76
- 2. Run server: `node server.js` (same cwd; `npm start` also works). If your MCP client allows, let the LLM start this process before keyword research and stop it after; otherwise start/stop it manually.
77
- 3. Register in your MCP client (example):
78
- ```json
79
- {
80
- "mcpServers": {
81
- "mcp-appstore": {
82
- "command": "node",
83
- "args": ["/ABSOLUTE/PATH/TO/pabal-web-mcp/external-tools/mcp-appstore/server.js"],
84
- "cwd": "/ABSOLUTE/PATH/TO/pabal-web-mcp/external-tools/mcp-appstore"
85
- }
86
- }
87
- }
88
- ```
89
- 4. Use it with `keyword-research` (saves to `.aso/keywordResearch/...`) before `improve-public` to supply keyword data.
90
-
91
- ### Supported Locales
92
-
93
- Supports all languages supported by each store.
94
-
95
- | Unified | App Store | Google Play |
96
- | ------- | --------- | ----------- |
97
- | en-US | en-US | en-US |
98
- | ko-KR | ko | ko-KR |
99
- | ja-JP | ja | ja-JP |
100
- | zh-CN | zh-Hans | zh-CN |
101
- | zh-TW | zh-Hant | zh-TW |
102
- | de-DE | de-DE | de-DE |
103
- | fr-FR | fr-FR | fr-FR |
104
- | es-ES | es-ES | es-ES |
105
- | pt-BR | pt-BR | pt-BR |
106
- | ... | ... | ... |
44
+ ## Configuration
45
+
46
+ Set `dataDir` in `~/.config/pabal-mcp/config.json`:
47
+
48
+ ```json
49
+ {
50
+ "dataDir": "/path/to/pabal-web"
51
+ }
52
+ ```
53
+
54
+ ## Tools
55
+
56
+ | Category | Tools |
57
+ | -------- | -------------------------------------------------------------------------------------- |
58
+ | ASO | `aso-to-public`, `public-to-aso`, `improve-public`, `validate-aso`, `keyword-research` |
59
+ | Apps | `init-project`, `search-app` |
60
+ | Content | `create-blog-html` |
61
+
62
+ See [documentation](./docs/en-US/README.md) for details.
107
63
 
108
64
  ## License
109
65
 
@@ -111,14 +67,8 @@ MIT
111
67
 
112
68
  ---
113
69
 
114
- <br>
115
-
116
- ## 🌐 Pabal Web
117
-
118
- Want to manage ASO and SEO together? Check out **Pabal Web**.
70
+ ## Pabal Web
119
71
 
120
72
  [![Pabal Web](public/pabal-web.png)](https://pabal.quartz.best/)
121
73
 
122
- **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.
123
-
124
- 👉 [Visit Pabal Web](https://pabal.quartz.best/)
74
+ Unified ASO + SEO management interface. [Visit →](https://pabal.quartz.best/)