@bataitools/agent-cli 0.1.0

package/examples/submit/base.json

@@ -0,0 +1,18 @@
+{
+  "website": "https://example.com",
+  "logo": "https://example.com/logo.png",
+  "developerType": "team",
+  "developerCountry": "US",
+  "developerProvince": "CA",
+  "categorys": ["productivity"],
+  "tags": ["ai-writing"],
+  "audiences": ["developers"],
+  "links": {
+    "pricingUrl": "https://example.com/pricing"
+  },
+  "social": {
+    "email": "hello@example.com",
+    "github": "https://github.com/example"
+  },
+  "productMedia": []
+}

package/examples/submit/i18n/en.json

@@ -0,0 +1,29 @@
+{
+  "name": "Example Tool",
+  "tagline": "The best example tool for developers building AI apps",
+  "description": "Example Tool helps developers ship faster with a complete toolkit for building, testing, and deploying AI-powered applications at scale.",
+  "instruction": "Sign up, connect your API key, and start building in minutes.",
+  "developerName": "Example Inc",
+  "coreFeatures": [
+    { "title": "Fast setup", "description": "Get started in under five minutes with guided onboarding." },
+    { "title": "Multi-model", "description": "Switch between leading LLM providers from one dashboard." },
+    { "title": "Team collab", "description": "Share prompts and workflows across your organization." }
+  ],
+  "useCases": ["Prototype AI features", "Internal knowledge bots", "Customer support automation"],
+  "pricing": [
+    {
+      "chargeType": "free",
+      "price": "0",
+      "features": ["Up to 1000 requests/month", "Community support"]
+    }
+  ],
+  "faqs": [
+    { "question": "Is there a free plan?", "answer": "Yes, the free tier includes 1000 requests per month." },
+    { "question": "Which models are supported?", "answer": "We support all major commercial and open models." },
+    { "question": "Can I self-host?", "answer": "Enterprise plans include self-hosted deployment options." }
+  ],
+  "seo": {
+    "title": "Example Tool — AI Developer Toolkit",
+    "description": "Build and ship AI apps faster with Example Tool."
+  }
+}

package/examples/submit.template.json

@@ -0,0 +1,55 @@
+{
+  "website": "https://example.com",
+  "logo": "https://example.com/logo.png",
+  "websiteScreenshot": "https://example.com/og.png",
+  "developerType": "team",
+  "developerCountry": "US",
+  "developerProvince": "CA",
+  "categorys": ["productivity"],
+  "tags": ["ai-writing"],
+  "audiences": ["developers"],
+  "links": {
+    "pricingUrl": "https://example.com/pricing"
+  },
+  "social": {
+    "email": "hello@example.com",
+    "github": "https://github.com/example"
+  },
+  "productMedia": [
+    {
+      "type": "youtube",
+      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+    }
+  ],
+  "i18n": {
+    "en": {
+      "name": "Example Tool",
+      "tagline": "The best example tool for developers building AI apps",
+      "description": "Example Tool helps developers ship faster with a complete toolkit for building, testing, and deploying AI-powered applications at scale.",
+      "instruction": "Sign up, connect your API key, and start building in minutes.",
+      "developerName": "Example Inc",
+      "coreFeatures": [
+        { "title": "Fast setup", "description": "Get started in under five minutes with guided onboarding." },
+        { "title": "Multi-model", "description": "Switch between leading LLM providers from one dashboard." },
+        { "title": "Team collab", "description": "Share prompts and workflows across your organization." }
+      ],
+      "useCases": ["Prototype AI features", "Internal knowledge bots", "Customer support automation"],
+      "pricing": [
+        {
+          "chargeType": "free",
+          "price": "0",
+          "features": ["Up to 1000 requests/month", "Community support"]
+        }
+      ],
+      "faqs": [
+        { "question": "Is there a free plan?", "answer": "Yes, the free tier includes 1000 requests per month." },
+        { "question": "Which models are supported?", "answer": "We support all major commercial and open models." },
+        { "question": "Can I self-host?", "answer": "Enterprise plans include self-hosted deployment options." }
+      ],
+      "seo": {
+        "title": "Example Tool — AI Developer Toolkit",
+        "description": "Build and ship AI apps faster with Example Tool."
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@bataitools/agent-cli",
+  "version": "0.1.0",
+  "description": "BAT AI Tools — Agent/Skill CLI for multi-language product submission",
+  "bin": {
+    "bat-agent": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "skills",
+    "prompts",
+    "examples"
+  ],
+  "scripts": {
+    "build": "bun build ./src/cli.ts --outdir ./dist --target node",
+    "dev": "bun run src/cli.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@bat/shared": "workspace:*",
+    "playwright": "^1.49.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "bun-types": "^1.3.14",
+    "typescript": "^5.7.2"
+  }
+}

package/prompts/01-generate-en.md

@@ -0,0 +1,48 @@
+# Phase 1 — Generate English only
+
+**Do NOT generate all languages in one step.** Only produce `base.json` + `i18n/en.json`.
+
+## Output files
+
+### `base.json` (shared, language-neutral)
+
+```json
+{
+  "website": "https://example.com",
+  "logo": "https://example.com/logo.png",
+  "websiteScreenshot": "https://static.../screenshot/.../en/....png",
+  "screenshots": { "en": "https://static.../en/....png" },
+  "developerType": "team",
+  "developerCountry": "US",
+  "developerProvince": "CA",
+  "categorys": ["productivity"],
+  "tags": ["ai-writing"],
+  "audiences": ["developers"],
+  "links": { "pricingUrl": "https://example.com/pricing" },
+  "social": { "email": "hello@example.com" },
+  "productMedia": [{ "type": "youtube", "url": "https://www.youtube.com/watch?v=..." }]
+}
+```
+
+### `i18n/en.json` (English text only)
+
+```json
+{
+  "name": "...",
+  "tagline": "...",
+  "description": "...",
+  "instruction": "...",
+  "developerName": "...",
+  "coreFeatures": [{ "title": "...", "description": "..." }],
+  "useCases": ["...", "...", "..."],
+  "pricing": [{ "chargeType": "free", "price": "0", "features": ["..."] }],
+  "faqs": [{ "question": "...", "answer": "..." }],
+  "seo": { "title": "...", "description": "..." }
+}
+```
+
+## Rules
+
+- Fetch taxonomy from `bat-agent schema en` — never invent category/tag/audience codes
+- Run `bat-agent capture-screenshot --website <url> --lang en --merge base.json` if no og:image
+- Validate English content meets minimum lengths before Phase 2

package/prompts/02-translate-i18n.md

@@ -0,0 +1,50 @@
+# Phase 2 — Translate from English
+
+Read **only** `i18n/en.json`. Translate text fields into other languages. Write **one file per language** under `i18n/`.
+
+## Target languages — all required (16 total)
+
+`en` plus: `zh, es, ja, de, fr, pt, ko, tw, it, ru, ar, nl, tr, vi, id`
+
+**Every language above must be present** before `bat-agent validate` / `submit` will pass.
+
+## Recommended batching (stability)
+
+Translate in batches of **3–4 languages per LLM call**, not all 15 at once:
+
+1. Batch A: `zh`, `tw`, `ja`, `ko`
+2. Batch B: `de`, `fr`, `it`, `nl`
+3. Batch C: `es`, `pt`, `ru`, `tr`
+4. Batch D: `ar`, `vi`, `id`
+
+Each batch output: separate files `i18n/zh.json`, `i18n/ja.json`, etc.
+
+## What to translate
+
+Translate all string text in:
+
+- `name`, `tagline`, `description`, `instruction`, `developerName`
+- `coreFeatures[].title`, `coreFeatures[].description`
+- `useCases[]` (if string items)
+- `pricing[].features[]`, pricing labels if present
+- `faqs[].question`, `faqs[].answer`
+- `seo.title`, `seo.description`
+
+## What NOT to translate or change
+
+- JSON keys
+- Array lengths (must match `en.json` exactly)
+- URLs, emails, product names that are proper nouns (keep brand name consistent)
+- `chargeType` enum values in pricing
+
+## Per-file output shape
+
+Each `i18n/<lang>.json` has the **same structure** as `i18n/en.json`, only with translated text.
+
+## After all languages
+
+```bash
+bat-agent pack ./submit -o submit.bundle.json
+bat-agent validate -f submit.bundle.json
+bat-agent submit -f submit.bundle.json
+```

package/prompts/generate-i18n.md

@@ -0,0 +1,7 @@
+# Deprecated — use two-phase prompts
+
+Do **not** generate all languages in one file.
+
+1. **Phase 1:** `01-generate-en.md` → `base.json` + `i18n/en.json`
+2. **Phase 2:** `02-translate-i18n.md` → `i18n/<lang>.json` (batched translation)
+3. **Phase 3:** `bat-agent pack ./submit -o submit.bundle.json`

package/skills/cursor/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: bat-submit
+description: Submit an AI tool to BAT AI Tools (bataitools.com) via bat-agent CLI. Use a 3-phase workflow — English first, then translate, then pack and submit.
+---
+
+# BAT AI Tools — Agent Submit Skill
+
+## Prerequisites
+
+1. 用户在 https://bataitools.com/submit 登录后生成 API Key（`bat_…`），执行 `bat-agent login <api-key>` — API 默认 `https://api.bataitools.com`
+2. 仅本地开发时：`BAT_API_URL=https://api-dev.bataitools.com` 或 `bat-agent login <api-key> --api https://api-dev.bataitools.com`
+3. `bat-agent` CLI from the `bat-agent` package
+
+
+## Critical: do NOT generate all languages in one JSON
+
+Large single-file JSON causes truncation and validation failures. Always use **3 phases**:
+
+| Phase | What | Output |
+|-------|------|--------|
+| **1. English** | Read website, taxonomy, screenshot | `base.json` + `i18n/en.json` |
+| **2. Translate** | Translate from `i18n/en.json` only | `i18n/zh.json`, `i18n/ja.json`, … |
+| **3. Submit** | Merge and POST once | `bat-agent pack` → `submit` → `publish` |
+
+Start with: `bat-agent init ./submit`
+
+---
+
+## Phase 1 — English only
+
+1. `bat-agent schema en`
+2. `bat-agent capture-screenshot --website <url> --lang en --merge ./submit/base.json`
+3. Read the user's website; write **only**:
+   - `submit/base.json` — shared fields (website, categorys, tags, screenshots, productMedia, …)
+   - `submit/i18n/en.json` — English text fields only
+
+See `prompts/01-generate-en.md`. **Stop after en.** Do not write other language files yet.
+
+---
+
+## Phase 2 — Translate from English
+
+1. Read `submit/i18n/en.json` as the **sole source**
+2. Translate text fields into other languages
+3. Write **one file per language**: `submit/i18n/zh.json`, `submit/i18n/ja.json`, …
+4. Translate in **batches of 3–4 languages** per LLM call (not all 15 at once)
+
+**All 16 languages are required** (en + 15). When BAT adds more site languages, requirements grow automatically — same LLM workflow, more global SEO for the listing owner.
+
+- Keep array lengths identical to `en.json`
+- Do not translate category/tag/audience slugs (they live in `base.json`)
+- Do not translate URLs, emails, or `chargeType` values
+
+See `prompts/02-translate-i18n.md`.
+
+---
+
+## Phase 3 — Pack and submit
+
+`bat-agent submit` **auto-detects** new vs update by `website` in the bundle:
+- not listed → `SUBMIT_AGENT` (new)
+- already listed → `UPDATE_AGENT` (update)
+
+Same commands for both:
+
+```bash
+bat-agent pack ./submit -o submit.bundle.json
+bat-agent validate -f submit.bundle.json
+bat-agent submit -f submit.bundle.json
+# after user confirms:
+bat-agent publish --id <submitId>
+bat-agent status --id <submitId>
+```
+
+---
+
+## Screenshot rules
+
+- **en required** — use `capture-screenshot` merged into `base.json`
+- Other langs: optional `--merge base.json --lang zh`; missing langs use en URL at display time
+
+## Rules
+
+- Taxonomy codes only from `bat-agent schema`
+- `website` must not include query parameters
+- Never skip Phase 1/2 and dump one giant `submit.json` with 16 languages
+
+## Prompt reference
+
+- `prompts/01-generate-en.md` — Phase 1
+- `prompts/02-translate-i18n.md` — Phase 2