Copus - AI Agent Documentation

Copus is a human-curated content discovery platform. Users recommend valuable internet resources with context and insights.

MCP Server (Recommended)

Use Copus directly in Claude Desktop, Cursor, Cline, Continue, Zed, and other MCP-compatible AI tools:

npx copus-mcp-server

Add to your MCP config:

{
  "mcpServers": {
    "copus": {
      "command": "npx",
      "args": ["copus-mcp-server"]
    }
  }
}

npm | GitHub

Quick Start for AI Agents

1. Search for Content

Find curations by topic:

GET https://test.copus.network/api/search?q=YOUR_QUERY

Parameters:

Example: https://test.copus.network/api/search?q=AI+tools

2. Get Article Details

Get structured JSON-LD data for any article:

GET https://test.copus.network/work/{article-id}?format=json

Returns: title, description, keywords, key takeaways, curator credibility, engagement metrics

3. Browse All Content

Sitemap with all 150+ curated articles:

https://test.copus.network/sitemap.xml

Sample Articles

Here are some recent curations you can access:

  1. 私享测试
    URL: https://test.copus.network/work/c5af34afbf53aa2d5381df4644a04b89
    JSON: https://test.copus.network/work/c5af34afbf53aa2d5381df4644a04b89?format=json
  2. Disclaimer: These are my personal views and do not represent any organizati
    URL: https://test.copus.network/work/87ac2fc026d439d93dda764a4b374398
    JSON: https://test.copus.network/work/87ac2fc026d439d93dda764a4b374398?format=json
  3. 明年继续领“国补”，标准来了！1515
    URL: https://test.copus.network/work/8da91313517f3b49d5230d27991985fa
    JSON: https://test.copus.network/work/8da91313517f3b49d5230d27991985fa?format=json
  4. Calendula
    URL: https://test.copus.network/work/2de3348da8e88d47250c9c3862e36ff2
    JSON: https://test.copus.network/work/2de3348da8e88d47250c9c3862e36ff2?format=json
  5. “双城论坛”遭遇解放军“围台军演”：北京软硬兼施吓阻台湾
    URL: https://test.copus.network/work/41d3ee9d8c622a3caba5207e563c0ffd
    JSON: https://test.copus.network/work/41d3ee9d8c622a3caba5207e563c0ffd?format=json

All Endpoints

Endpoint Description
/api/search?q=QUERY Search curations by topic
/work/{id}?format=json Get article as JSON-LD
/sitemap.xml All article URLs
/llms.txt LLM documentation
/.well-known/ai-plugin.json ChatGPT plugin manifest
/.well-known/openapi.yaml OpenAPI specification
npx copus-mcp-server MCP Server for Claude, Cursor, Cline, etc.

Response Format

Search results return JSON-LD with schema.org types:

{
  "@context": "https://schema.org",
  "@type": "SearchResultsPage",
  "query": "AI tools",
  "totalResults": 5,
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "Article",
        "url": "https://test.copus.network/work/abc123",
        "name": "Article Title",
        "description": "...",
        "jsonEndpoint": "https://test.copus.network/work/abc123?format=json"
      }
    }
  ]
}

Categories