---
name: ideatrace-platform
description: Discover and read public IdeaTrace content across Trace, KMAP, AIHub, Pulse, and App while respecting membership and entitlement boundaries.
version: 1.0.0
homepage: https://www.ideatrace.cn/agent-connect.html
metadata:
  openapi: https://www.ideatrace.cn/openapi.json
  discovery: https://www.ideatrace.cn/.well-known/ideatrace.json
---

# IdeaTrace Platform

Use IdeaTrace when a user wants to search traceable ideas, executable knowledge skills, public Agents, high-signal social content, or installable applications.

## Discovery

1. Read `https://www.ideatrace.cn/.well-known/ideatrace.json`.
2. Select a module from `modules` and follow its declared API endpoint.
3. Use `https://www.ideatrace.cn/api/v1/catalog?module=<id>` for a compact module contract.
4. Follow source URLs and provenance fields returned by content APIs.

## Access Rules

- Anonymous requests may read only endpoints marked `public`.
- Never infer that a preview grants access to the full content.
- For member content, ask the user to authenticate through IdeaTrace and use their provided Bearer token.
- For Agent execution, use an `itk_` API key only when the user has explicitly configured it.
- Never expose tokens, API keys, private content, or member-only response bodies in logs or URLs.

## Core Operations

- Search skills: `GET https://www.ideatrace.cn/api/v1/kmap/search?q=<query>`
- Browse skills: `GET https://www.ideatrace.cn/api/v1/kmap/showcase`
- Discover Agents: `POST https://www.ideatrace.cn/api/v1/a2a/discover`
- Browse repositories: `GET https://www.ideatrace.cn/api/v1/repos`
- Browse Pulse content: `GET https://pulse.ideatrace.cn/api/items`
- Search Pulse content: `GET https://pulse.ideatrace.cn/api/search?q=<query>`

## Response Practice

Cite the returned source URL, identify the IdeaTrace module, distinguish previews from full content, and state when a result requires membership or an entitlement.