---
name: use-gugudata-api
description: Discover and use GuGuData public APIs through OpenAPI, Remote MCP, developer docs, appkey authentication, and agent-readable API Markdown.
---

# Use GuGuData API

Use this skill when an agent needs to discover, inspect, or call GuGuData public API endpoints.

## Discovery

- API catalog: https://gugudata.io/.well-known/api-catalog
- OpenAPI 3.1 definition: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json
- Developer docs: https://developers.gugudata.io/
- API healthcheck: https://api.gugudata.io/healthcheck
- Remote MCP guide: https://gugudata.io/mcp
- Remote MCP server card: https://gugudata.io/.well-known/mcp/server-card.json
- Remote MCP endpoint: https://mcp.gugudata.io/mcp

## API Details

Use `https://gugudata.io/details/{apiIdentity}/` for human-readable API details and `https://gugudata.io/details/{apiIdentity}/llm.md` for raw Markdown optimized for agents.

## Authentication

GuGuData public API endpoints use an `appkey` query parameter. Read the OpenAPI security scheme and endpoint parameters before calling an API. Never invent or expose an appkey. If no appkey is available, inspect documentation and demo pages instead of attempting authenticated production calls.

Remote MCP clients use OAuth at `https://mcp.gugudata.io`. Prefer Remote MCP when the user wants to connect an AI client without copying appkeys into the client.

## Calling APIs

1. Read the OpenAPI definition and select the endpoint by path and operation.
2. Confirm required parameters, method, response format, and status-code behavior.
3. Add `appkey` only when the user has explicitly provided or selected a valid key.
4. Prefer demo pages and `/details/{apiIdentity}/llm.md` for exploration that does not require credentials.
5. Treat binary endpoints as file responses on success and JSON responses for authentication or validation errors.

## Safety

Do not perform purchases, portal login, key reset, account updates, or dashboard actions through this skill. Use this skill for read-only discovery and user-authorized API calls only.