.codex-plugin/plugin.json

{
    "interface": {
        "brandColor": "#1D1DE0",
        "capabilities": [
            "Read",
            "Write"
        ],
        "category": "Productivity",
        "composerIcon": "./assets/composer-icon.png",
        "defaultPrompt": [
            "Use Answer Socrates to pull keywords for creatine gummies",
            "Compare Google Trends for peptides in the UK vs the US",
            "What searches are rising around home fitness right now?"
        ],
        "developerName": "Toast Media FZCO",
        "displayName": "Answer Socrates",
        "logo": "./assets/logo.png",
        "longDescription": "Answer Socrates is an SEO keyword research tool that brings real Google search data into ChatGPT, so you can research topics and plan content without leaving the chat.\n\nWhat you can do:\n- Keyword research: pull the searches people actually type into Google, grouped into Questions, Prepositions, Comparisons and Autocomplete. Usually hundreds of keywords per pull.\n- Google Trends: 12 months of weekly search interest for any keyword in any country. Spot seasonality, compare keywords, or compare the same keyword across countries.\n- Rising topics: related searches growing fastest right now, including Breakouts.\n- Keyword clustering: group a keyword list into topics, with search intent and funnel stage for every keyword, to turn research into a content plan.\n- Projects: save keyword lists into your Answer Socrates projects so your team sees them in the app.\n\nHow it works: sign in with your existing Answer Socrates account. Data defaults to the United States; name a country to switch markets.\n\nGood to know: results are keyword suggestions and relative Google Trends interest (0 to 100), not monthly search volumes. Projects can only be archived or deleted in the Answer Socrates app.",
        "privacyPolicyURL": "https://answersocrates.com/privacy",
        "screenshots": [
            "./assets/screenshot-keywords.webp",
            "./assets/screenshot-trends.webp",
            "./assets/screenshot-plan.webp"
        ],
        "shortDescription": "Keyword research and trends",
        "supportURL": "https://answersocrates.com/",
        "termsOfServiceURL": "https://answersocrates.com/terms",
        "websiteURL": "https://answersocrates.com/mcp/chatgpt"
    },
    "extensions": {
        "com.openai": {
            "review": {
                "demo_recording_url": "https://www.tella.tv/video/chatgpt-seo-plugin-overview-cnr11s7u",
                "test_cases": {
                    "negative": [
                        {
                            "description": "Unrelated creative request: the plugin should not be used.",
                            "prompt": "Write me a short poem about the ocean"
                        },
                        {
                            "description": "Search volume is not something this plugin provides: it should say so rather than invent numbers.",
                            "prompt": "What is the exact monthly search volume for creatine gummies?"
                        },
                        {
                            "description": "Deleting projects is not possible through the plugin: it should explain this is done in the Answer Socrates app.",
                            "prompt": "Delete my Supplements project in Answer Socrates"
                        }
                    ],
                    "positive": [
                        {
                            "description": "Keyword pull for a seed term.",
                            "expected_behavior": "Calls get_keywords once for \"creatine gummies\" (US, English) and replies with the total keyword count, then the count per group (Questions, Prepositions, Comparisons, Autocomplete) and examples from each group. Uses 1 request.",
                            "prompt": "Use Answer Socrates to pull keywords for creatine gummies",
                            "tools_triggered": "get_keywords"
                        },
                        {
                            "description": "Compare one keyword across two countries.",
                            "expected_behavior": "Calls get_trends for \"peptides\" with country GB and with country US, then compares the two 12-month weekly series (peaks, direction, seasonality) and notes the values are relative interest from 0 to 100, scaled per country. Uses 2 requests.",
                            "prompt": "Compare Google Trends for peptides in the UK vs the US over the last 12 months",
                            "tools_triggered": "get_trends (twice: country GB and US)"
                        },
                        {
                            "description": "Discover rising related searches.",
                            "expected_behavior": "Calls get_rising_topics for \"home fitness\" and lists the rising related searches with their growth, marking any Breakouts, plus the top established related searches. Uses 1 request.",
                            "prompt": "What searches are rising around home fitness right now?",
                            "tools_triggered": "get_rising_topics"
                        },
                        {
                            "description": "Cluster a keyword list into topics, with the cost confirmed first.",
                            "expected_behavior": "Before calling, states it will send 12 keywords and spend 12 cluster credits, and waits for the user to agree. After agreement, calls cluster_keywords and presents the topics with their keywords, each keyword's search intent and funnel stage, and any unclustered keywords.",
                            "prompt": "Cluster these keywords into topics: best creatine gummies, creatine gummies for women, creatine gummies vs powder, do creatine gummies work, creatine gummies side effects, how many creatine gummies per day, creatine gummies amazon, creatine gummies reviews, sugar free creatine gummies, vegan creatine gummies, creatine gummies for men, when to take creatine gummies",
                            "tools_triggered": "cluster_keywords"
                        },
                        {
                            "description": "Save research into an existing project.",
                            "expected_behavior": "Calls get_keywords, then list_projects to find the project named Supplements, then save_to_project with that project and the pulled keywords. Confirms the list is saved and visible in the Answer Socrates app. Saving is free; the pull uses 1 request.",
                            "prompt": "Pull keywords for creatine gummies and save them to my Supplements project",
                            "tools_triggered": "get_keywords, list_projects, save_to_project"
                        }
                    ]
                }
            },
            "publication": {
                "countries": [],
                "release_notes": "Keyword research, Google Trends, rising topics and keyword clustering from real Google data, with saving to your Answer Socrates projects."
            }
        }
    },
    "name": "answer-socrates",
    "version": "1.0.5",
    "description": "Keyword research, Google Trends, rising topics and keyword clustering from real Google data.",
    "author": {
        "name": "James Oliver",
        "email": "jamesspenceroliver@gmail.com",
        "url": "https://answersocrates.com"
    },
    "keywords": [
        "seo",
        "keyword research",
        "google trends",
        "content planning"
    ],
    "homepage": "https://answersocrates.com/mcp/chatgpt",
    "mcpServers": "./.mcp.json"
}