plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "selfpubgo",
  "version": "1.0.0",
  "description": "Ask about your Amazon KDP books and Amazon Ads in SelfPub Go, and change campaigns only after you confirm.",
  "author": {
    "name": "SOFTSURE LLC",
    "email": "support@selfpubgo.com",
    "url": "https://selfpubgo.com"
  },
  "homepage": "https://selfpubgo.com/modules/claude-chatgpt",
  "keywords": [
    "kdp",
    "amazon ads",
    "self-publishing",
    "books",
    "advertising"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SelfPub Go",
        "shortDescription": "Amazon Ads for KDP authors",
        "longDescription": "SelfPub Go is the ads and book-economics app for authors who publish on Amazon KDP. This plugin connects ChatGPT to your SelfPub Go account, so you can ask about your books and Amazon Ads in plain words.\n\nWhat you can do:\n- Check how your ads did: spend, sales, orders and ACOS for any period, by campaign, keyword, placement or hour, plus a two-day summary of what went well and what went wrong.\n- Find wasted spend: the search terms shoppers typed, words that keep spending without selling, off-topic searches, and negative keyword candidates.\n- Know what a sale is worth: royalty per sale, break-even ACOS and the highest cost per click that still pays, per edition and marketplace.\n- Follow your ranks: Best Sellers Rank, ratings, review counts and the positions of the keywords you track.\n- Plan new books: your launch board and book projects, KDP calculators (royalty, cover size, page count, sales from Best Sellers Rank), niche research, ideas from your own ads, and checks of titles, descriptions and keyword fields against KDP rules.\n- See why a campaign is not showing, today's budget pacing, Amazon's suggested bids and budgets, and your Amazon Ads billing status.\n- Make changes with a preview: bids, budgets, pausing, negative keywords, new keywords and targets, new Sponsored Products, Sponsored Brands and Sponsored Display campaigns, book ideas and projects, and a new book's ads launch, whose campaigns start spending once created. Every proposal lists each item before and after, and nothing is applied until you say yes. Each applied change is recorded in your SelfPub Go change history, marked as made by AI, and can be undone.\n\nWho it is for: self-published authors and small publishers who run Amazon Ads for their books and manage them in SelfPub Go.\n\nLimits:\n- Requires a SelfPub Go account with Amazon Ads connected in the SelfPub Go desktop app for macOS or Windows.\n- Answers come from the copy of your Amazon Ads data that SelfPub Go keeps, and each answer says how fresh it is. A few lookups are read live from Amazon and have a daily limit.\n- KDP royalty reports stay on your computer and are not available through this plugin.\n- It cannot change your sign-in, billing or Amazon connection, make payments, or see other authors' data.\n- When you connect, you choose read-only access or allow changes, and you can disconnect at any time in SelfPub Go.",
        "developerName": "SOFTSURE LLC",
        "category": "Business & Operations",
        "capabilities": [
          "Two-day summary of Amazon Ads results",
          "Results by campaign, keyword, placement and hour",
          "Search terms, off-topic searches and words that spend without selling",
          "Royalty per sale, break-even ACOS and max cost per click per edition",
          "Best Sellers Rank, ratings and tracked keyword positions",
          "Book launch board, book projects and release plans",
          "KDP calculators: royalty, cover size, page count, sales from BSR",
          "Niche research and book ideas from your own ads",
          "Checks of titles, descriptions and keyword fields against KDP rules",
          "Bid, budget, campaign, book idea and ads launch changes after your yes",
          "Change history with undo"
        ],
        "websiteURL": "https://selfpubgo.com",
        "supportURL": "https://selfpubgo.com/contact",
        "privacyPolicyURL": "https://selfpubgo.com/privacy",
        "termsOfServiceURL": "https://selfpubgo.com/terms",
        "defaultPrompt": [
          "What went well and what went wrong with my ads in the last 2 days?",
          "Which search terms spent money without a sale this month?",
          "What is the break-even ACOS of each of my books?"
        ],
        "brandColor": "#10B981",
        "brandColorDark": "#34D399",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "demo_recording_url": "https://youtu.be/eNO5OINVz6A",
        "test_cases": {
          "positive": [
            {
              "description": "Daily check of ad results",
              "prompt": "What went well and what went wrong with my ads in the last 2 days?",
              "tools_triggered": "get_performance, get_search_terms, get_sync_status",
              "expected_behavior": "Summarizes the last two full days of the test account against a usual day before them: spend, sales, orders and ACOS, with up to three good and three bad points, and says how fresh the data is. Changes nothing."
            },
            {
              "description": "Find search terms that waste money",
              "prompt": "Which search terms spent money without a sale in the last 30 days?",
              "tools_triggered": "get_search_terms",
              "expected_behavior": "Lists search terms from the test account with clicks and spend but no orders, highest spend first. It may offer to propose negative keywords but applies nothing."
            },
            {
              "description": "Book economics",
              "prompt": "List my books, then tell me the break-even ACOS and the highest bid that still pays for one of the paperbacks.",
              "tools_triggered": "list_books, get_book",
              "expected_behavior": "Lists the test account's books and, for one paperback, gives royalty per sale, break-even ACOS and maximum cost per click for each marketplace, marking estimates as estimates."
            },
            {
              "description": "Ranks of tracked books",
              "prompt": "How do my tracked books rank on Amazon, and how old are those readings?",
              "tools_triggered": "get_ranks",
              "expected_behavior": "Returns Best Sellers Rank, rating, review count and tracked keyword positions for the test account's books, each with the age of the reading."
            },
            {
              "description": "A change applied only after confirmation",
              "prompt": "Lower the bid by 10% on the keyword with the highest ACOS in my biggest campaign.",
              "tools_triggered": "get_performance, get_target_performance, propose_bid_changes, apply_change",
              "expected_behavior": "Finds the keyword, shows a proposal with the bid before and after, and waits. Only after the reviewer answers yes does it apply the change and report what changed; the change then appears in the change history (list_ai_changes) and can be undone with propose_undo. In the test account the change stays inside SelfPub Go and is never sent to Amazon."
            }
          ],
          "negative": [
            {
              "description": "Payments are out of scope: SelfPub Go cannot pay invoices or move money. Expect a plain explanation and no tool that changes anything.",
              "prompt": "Pay my latest Amazon Ads invoice with my saved card."
            },
            {
              "description": "KDP royalty reports are not available through this plugin; they stay in the SelfPub Go app on the author's computer. Expect a plain explanation, not invented numbers.",
              "prompt": "Download my KDP royalty report for last month."
            },
            {
              "description": "Only the connected account's data is available. Expect a refusal to look up another author's campaigns.",
              "prompt": "Show me the ad campaigns and results of another author's books."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "SelfPub Go does not sell products or process payments in ChatGPT."
      },
      "publication": {
        "release_notes": "First public version: read books, book projects, Amazon Ads results, search terms, ranks and billing status from SelfPub Go; KDP calculators, niche research and checks of listing texts; propose bid, budget, status, keyword, campaign, book idea and new-book ads launch changes that are applied only after the user's yes; change history with undo."
      },
      "apps": "./.app.json"
    }
  }
}