GXceed Paper Search API

Claude does not consume OpenAPI directly. The spec serves as the basis for a thin MCP-compatible tool wrapper that exposes the single searchPapers operation. Because the endpoint needs no auth and sends CORS *, the wrapper can call it directly.

# The single operation a thin MCP/tool wrapper exposes:
searchPapers(q, topic?, lang?, limit?, offset?)
  → GET https://gxceed.com/api/v1/papers/search

# Spec: https://gxceed.com/openapi.json  (operationId: searchPapers)
# No auth, CORS *, so the wrapper can call it directly.

async function searchPapers(args) {
  const u = new URL("https://gxceed.com/api/v1/papers/search");
  u.searchParams.set("q", args.q);
  if (args.topic) u.searchParams.set("topic", args.topic);
  if (args.lang)  u.searchParams.set("lang", args.lang);
  if (args.limit) u.searchParams.set("limit", String(args.limit));
  const res = await fetch(u);            // no auth, CORS *
  return await res.json();               // { api_version, total, results[] }
}

Register searchPapers as a Gemini function declaration. The parameter schema mirrors the OpenAPI spec; on a function call, your app issues the GET request below.

{
  "tools": [{
    "functionDeclarations": [{
      "name": "searchPapers",
      "description": "Search GX, ESG, and climate disclosure papers indexed by GXceed.",
      "parameters": {
        "type": "object",
        "properties": {
          "q":     { "type": "string",  "description": "Up to 5 AND-combined terms (2-500 chars)" },
          "topic": { "type": "string",  "description": "Optional topic slug" },
          "lang":  { "type": "string",  "enum": ["ja", "en", "all"] },
          "limit": { "type": "integer", "description": "1-50, default 10" }
        },
        "required": ["q"]
      }
    }]
  }]
}
// On a searchPapers(args) call, run:
//   GET https://gxceed.com/api/v1/papers/search?q=...&topic=...&lang=...&limit=...

In the GPT editor, choose "Add actions" → import from URL → paste https://gxceed.com/openapi.json. No auth required.

Use any OpenAPI-based tool loader. Point to /openapi.json. The endpoint supports CORS so it can be called directly from any environment.