plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "trends-by-country",
  "version": "1.0.0",
  "description": "Trends by Country shows what people search for and read right now in a country, from Google Trends and Wikipedia's most-read articles, with each topic explained in plain English.",
  "author": {
    "name": "Agent Tools",
    "email": "support@openkrill.app",
    "url": "https://tools.openkrill.app/"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Trends by Country",
        "shortDescription": "What a country searches now",
        "longDescription": "Trends by Country shows what people search for and read right now in a country, with each topic explained in plain English. Ask \"what is trending in Vietnam?\", \"top searches in the US today\" or \"what are people in Japan reading on Wikipedia?\".\n\nThe data comes from two public sources: Google Trends \"trending now\" for 125 countries, read 4 times a day, and Wikipedia's most-read articles per country from the Wikimedia Analytics API, read daily. Many trends are in the local language, so each one comes with what it is in English and, when the news headlines give a reason, one line on why it trends.\n\nEvery item names its source and links back to it: the Google Trends page for the search, or the Wikipedia article. Each answer carries the credit line for its sources. A second tool lists the countries that have trends right now.\n\nIt is free and needs no account. It stores nothing about you. The same data is on the public page at trends.openkrill.app.",
        "developerName": "Agent Tools",
        "category": "Data & Analytics",
        "capabilities": [
          "Lists what people search for now in a country, from Google Trends",
          "Lists the most-read Wikipedia articles in a country",
          "Explains each trend in English, with why it trends when the news says",
          "Links every item back to its source and gives the credit line",
          "Lists the countries that have trends now",
          "Free, no account, nothing stored about you"
        ],
        "websiteURL": "https://trends.openkrill.app/",
        "supportURL": "https://tools.openkrill.app/support",
        "privacyPolicyURL": "https://tools.openkrill.app/privacy",
        "termsOfServiceURL": "https://tools.openkrill.app/terms",
        "defaultPrompt": [
          "What is trending in Vietnam right now?",
          "What are the top searches in the US today?",
          "Which countries can you show trends for?"
        ],
        "brandColor": "#B5381C",
        "logo": "./assets/icon-512.png",
        "composerIcon": "./assets/icon-512.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Calls trending_in with country \"Vietnam\".",
              "prompt": "What is trending in Vietnam right now?",
              "tools_triggered": "trending_in",
              "expected_behavior": "Up to 10 Vietnamese trends from Google Trends and Wikipedia, each with its English meaning, source name and link, then the credit lines and the page link https://trends.openkrill.app/#VN."
            },
            {
              "description": "Calls trending_in with country \"US\" and source \"google-trends\".",
              "prompt": "What are the top Google searches in the US today?",
              "tools_triggered": "trending_in",
              "expected_behavior": "US Google Trends searches with their search volume band, English meaning, why each trends when known and a Google Trends link, with the Google Trends credit."
            },
            {
              "description": "Calls trending_in with country \"Japan\" and source \"wikipedia\".",
              "prompt": "What are people in Japan reading on Wikipedia?",
              "tools_triggered": "trending_in",
              "expected_behavior": "The most-read Japanese Wikipedia articles with pageviews, English meaning and article links, with the Wikipedia CC BY-SA credit."
            },
            {
              "description": "Calls countries.",
              "prompt": "Which countries can you show trends for?",
              "tools_triggered": "countries",
              "expected_behavior": "The list of countries with trends now, each with its 2-letter code."
            },
            {
              "description": "Calls trending_in with country \"Brazil\" and limit 5.",
              "prompt": "Give me the top 5 trends in Brazil, explained in English.",
              "tools_triggered": "trending_in",
              "expected_behavior": "At most 5 Brazilian trends, each with an English meaning, its source and a link back."
            }
          ],
          "negative": [
            {
              "description": "The country decides the answer; the tool must not guess it, so the assistant asks which country first.",
              "prompt": "What is trending?"
            },
            {
              "description": "The plugin reads Google Trends and Wikipedia only; it has no data on other sites, so it does not invent posts.",
              "prompt": "What is trending on TikTok in Brazil?"
            },
            {
              "description": "Writing asks for no trend data, so no tool is called.",
              "prompt": "Write a poem about autumn in Hanoi."
            }
          ]
        },
        "demo_recording_url": "https://trendsbycountry.openkrill.app/demo.mp4",
        "commerce": false
      },
      "publication": {
        "release_notes": "First release. trending_in returns a country's trends from Google Trends and Wikipedia's most-read articles, each with its English meaning, why it trends when known, the source name, a link back and the credit line. countries lists the countries that have trends now."
      },
      "apps": "./.app.json"
    }
  }
}