plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "recherche-externe",
  "version": "0.1.0",
  "description": "A research and verification toolkit with real internet access: keyless web search, live fetch of any URL or PDF as readable text, and official legal text from LegisQuebec and Justice Canada (with source URL). Case law is returned as CanLII/SOQUIJ search links. Read-oriented; never answers from memory, cites excerpt and URL.",
  "author": {
    "name": "mmcco",
    "email": "infodev@mmcco.co",
    "url": "https://connecteur-recherche-externe.vercel.app"
  },
  "homepage": "https://connecteur-recherche-externe.vercel.app",
  "license": "MIT",
  "keywords": [
    "research",
    "verification",
    "legal",
    "quebec",
    "web-search",
    "sources",
    "legisquebec",
    "justice-canada"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Recherche Externe",
        "shortDescription": "Cite real web & legal sources",
        "longDescription": "Recherche Externe is a research and verification toolkit with real internet access for AI agents. Its golden rule is to never answer from memory: every fact, article or figure it asserts should come from a page actually fetched, with the excerpt and the URL cited. It does six things. (1) chercher_web runs a keyless, best-effort general web search, trying Bing then DuckDuckGo (often rate-limited from a server) and falling back to the Wikipedia search API; it returns titles, URLs and snippets to locate sources and reports which engine was used, without claiming to know the page contents. (2) lire_page fetches a URL and returns its readable text (title and content) live, for the general web, LegisQuebec, Justice Canada and PDF files, whose text is extracted page by page; it does not execute JavaScript, so purely dynamic or bot-protected pages may fail. (3) loi_quebec fetches the exact official text of a Quebec statute or regulation article from LegisQuebec and returns it with its URL. (4) loi_federale fetches federal statute text from laws-lois.justice.gc.ca (for example the Bankruptcy and Insolvency Act). (5) chercher_jurisprudence builds reliable CanLII and SOQUIJ case-law search links to open in a browser: because CanLII blocks automated server-side fetching, this tool does not claim to read decisions, it only provides links. (6) sources_officielles_qc returns verified links and the matching tool to use for official Quebec sources by theme (case law, statutes and regulations, professional orders, land and real-estate records). Recherche Externe is read-oriented: it only searches and reads public sources, needs no account, and never modifies, sends, deploys or acts in any external system. When a source is unreachable it says so (\"not verified - source unreachable\") instead of filling the gap with a plausible reconstruction, and it marks any text longer than the requested limit as truncated rather than presenting it as complete.",
        "developerName": "mmcco",
        "category": "Education & Research",
        "capabilities": [
          "Keyless web search (Bing/DuckDuckGo, Wikipedia fallback) and live fetch of any URL or PDF as readable text.",
          "Retrieves official legal text live from LegisQuebec (Quebec) and Justice Canada (federal), with the source URL.",
          "Read-only: searches and reads public sources and cites excerpt plus URL; case law returns CanLII/SOQUIJ links."
        ],
        "websiteURL": "https://connecteur-recherche-externe.vercel.app",
        "supportURL": "https://connecteur-recherche-externe.vercel.app",
        "privacyPolicyURL": "https://connecteur-recherche-externe.vercel.app/privacy",
        "termsOfServiceURL": "https://connecteur-recherche-externe.vercel.app/terms",
        "defaultPrompt": [
          "Give me the official text of article 1457 of the Civil Code of Quebec (CCQ-1991) with the source URL.",
          "Search the web for recent sources on Quebec tenant rights and list the titles with their links.",
          "Open this URL and summarize only what the page actually says, citing the exact excerpt."
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://connecteur-recherche-externe.vercel.app/demo.gif",
        "test_cases": {
          "positive": [
            {
              "description": "General web search to locate sources",
              "prompt": "Search the web for sources about the right to disconnect in Quebec workplaces.",
              "tools_triggered": "chercher_web",
              "expected_behavior": "Calls chercher_web; returns titles, URLs and snippets (the engine field shows Bing, DuckDuckGo or the Wikipedia fallback) so the user can locate sources. Read-only; it does not claim to know the page contents."
            },
            {
              "description": "Fetch and read a live URL or PDF",
              "prompt": "Open https://www.legisquebec.gouv.qc.ca/en/document/cs/CCQ-1991 and tell me what the page actually says.",
              "tools_triggered": "lire_page",
              "expected_behavior": "Calls lire_page; fetches the live URL and returns its readable text (title and content), extracting PDF text page by page when applicable. Read-only; no JavaScript is executed."
            },
            {
              "description": "Official Quebec statute article",
              "prompt": "Give me the official text of article 1457 of the Civil Code of Quebec (CCQ-1991).",
              "tools_triggered": "loi_quebec",
              "expected_behavior": "Calls loi_quebec; fetches the exact article text from LegisQuebec live and returns it with the source URL. It does not reproduce the law from memory, and marks text longer than the limit as truncated. Read-only."
            },
            {
              "description": "Official federal statute article",
              "prompt": "Pull section 183 of the Bankruptcy and Insolvency Act (BIA) from Justice Canada.",
              "tools_triggered": "loi_federale",
              "expected_behavior": "Calls loi_federale; fetches the article text live from laws-lois.justice.gc.ca and returns it with the source URL. It does not reproduce the law from memory. Read-only."
            },
            {
              "description": "Case-law search links",
              "prompt": "Find Quebec Court of Appeal case law on good faith in contracts.",
              "tools_triggered": "chercher_jurisprudence",
              "expected_behavior": "Calls chercher_jurisprudence; returns reliable CanLII and SOQUIJ search links to open in a browser. It does not claim to read the decisions, because CanLII blocks automated server-side fetching. Read-only."
            }
          ],
          "negative": [
            {
              "description": "Creative writing (out of scope)",
              "prompt": "Write me a haiku about the first snowfall.",
              "expected_behavior": "No tool is triggered: this is creative writing with no fact, source or legal text to fetch or verify."
            },
            {
              "description": "Perform an action (out of scope)",
              "prompt": "Send an email to my lawyer summarizing this case for me.",
              "expected_behavior": "No tool is triggered: the connector only searches and reads public sources; it cannot send messages or take actions in any external system."
            },
            {
              "description": "Private or authenticated access (out of scope)",
              "prompt": "Log into my CanLII account and download the full PDF of my saved decision.",
              "expected_behavior": "No tool is triggered: the connector fetches only public pages and cannot authenticate or access private accounts; for case law it returns public search links instead."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial release. Recherche Externe is a research and verification toolkit with real internet access: keyless general web search, live fetch of any URL or PDF as readable text, and retrieval of official legal text from LegisQuebec (Quebec statutes and regulations) and Justice Canada (federal statutes), always returned with the source URL. Case law is provided as reliable CanLII and SOQUIJ search links because CanLII blocks automated server-side fetching. Read-oriented and account-free: it searches and reads public sources, cites the excerpt and URL, flags unreachable sources instead of guessing, and never modifies, sends or acts in any external system."
      },
      "apps": "./.app.json"
    }
  }
}