plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "bookbidder",
  "version": "1.0.0",
  "author": {
    "name": "BookBidder",
    "email": "dev@bookbidder.ai",
    "url": "https://bookbidder.ai"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "BookBidder",
        "shortDescription": "Amazon Ads and book profits",
        "longDescription": "BookBidder automates Amazon Ads bid optimization for KDP authors and publishers. This plugin lets ChatGPT read your BookBidder account so you can ask plain-English questions about your ads and get answers backed by your real numbers: a full account audit, profit and TACoS per book, wasted spend, every change BookBidder made and why, and pending Smart Advisor recommendations. Profit combines Amazon Ads data with KDP royalties, so you see true profit per book, not just ACOS. Access is read-only: ChatGPT cannot change bids, budgets, or campaigns. Requires a BookBidder account with Amazon Ads connected.",
        "developerName": "BookBidder",
        "category": "Productivity",
        "capabilities": [
          "Audit Amazon Ads",
          "Book profit and TACoS",
          "Wasted spend",
          "Activity log",
          "Smart Advisor recommendations"
        ],
        "websiteURL": "https://bookbidder.ai",
        "supportURL": "https://bookbidder.ai/help/ai-assistants",
        "privacyPolicyURL": "https://bookbidder.ai/privacy",
        "termsOfServiceURL": "https://bookbidder.ai/terms",
        "defaultPrompt": [
          "Audit my Amazon Ads account",
          "Which of my books lose money on ads?",
          "Where am I wasting ad spend?"
        ],
        "brandColor": "#F97316",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "commerce": false,
        "commerce_description": "BookBidder reports on the user's own Amazon Ads performance. It does not sell products or process payments.",
        "test_cases": {
          "positive": [
            {
              "description": "Account audit",
              "prompt": "Audit my Amazon Ads account",
              "tools_triggered": "get_account_audit",
              "expected_behavior": "Summarizes 30-day spend, sales and ACOS vs the previous 30 days, profit by book, wasted spend, top targets, and campaigns flagged for attention."
            },
            {
              "description": "Unprofitable books",
              "prompt": "Which of my books lose money on ads?",
              "tools_triggered": "list_books_profit",
              "expected_behavior": "Lists each book with royalties, ad spend, net profit and TACoS, and identifies books with negative net or high TACoS."
            },
            {
              "description": "Wasted spend",
              "prompt": "Where am I wasting ad spend?",
              "tools_triggered": "get_wasted_spend",
              "expected_behavior": "Lists targets with 10+ clicks and zero orders over 30 days, with campaign, spend per target, and total wasted spend."
            },
            {
              "description": "Recent changes",
              "prompt": "What did BookBidder change in my campaigns this week and why?",
              "tools_triggered": "get_activity_log",
              "expected_behavior": "Lists recent bid changes and other actions with the campaign and the reason or strategy for each."
            },
            {
              "description": "Recommendations",
              "prompt": "What is Smart Advisor recommending, and why?",
              "tools_triggered": "get_smart_advisor_queue",
              "expected_behavior": "Lists open recommendations with type, campaign and plain-English reason, and notes that decisions are made in the BookBidder app."
            }
          ],
          "negative": [
            {
              "description": "Write request (read-only)",
              "prompt": "Raise the bid on my best keyword by 20%"
            },
            {
              "description": "Unrelated request",
              "prompt": "What's the weather in Austin today?"
            },
            {
              "description": "Data outside the user's account",
              "prompt": "Show me my competitors' Amazon ad spend"
            }
          ]
        }
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: read-only access to Amazon Ads performance, book profit, wasted spend, activity log and Smart Advisor recommendations."
      },
      "apps": "./.app.json"
    }
  }
}