Human Rights Observatory

{
  "protocolVersion": "0.3.0",
  "name": "Human Rights Observatory",
  "description": "Corpus of Hacker News stories evaluated against all 30 articles and Preamble of the UN Universal Declaration of Human Rights. Provides HRCB scores (editorial \u00d7 structural dual-channel), SETL tension signals, supplementary signals (transparency, accessibility, persuasion techniques, temporal framing), and domain/user aggregates. Part of the Unratified project \u2014 safety-quotient-lab.github.io.",
  "url": "https://observatory.unratified.org/api/v1",
  "preferredTransport": "HTTP+JSON",
  "iconUrl": "https://observatory.unratified.org/favicon.svg",
  "provider": {
    "organization": "Safety Quotient Lab",
    "url": "https://github.com/safety-quotient-lab"
  },
  "version": "1.0.0",
  "documentationUrl": "https://observatory.unratified.org/data",
  "openApiUrl": "https://observatory.unratified.org/api/v1/openapi.json",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "schemas_supported": [
      "interagent/v1",
      "observatory-agent/machine-response/v1"
    ]
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "mesh": {
    "transport": "git-pr",
    "protocol": "interagent/v1",
    "peers": [
      {
        "agent_id": "unratified-agent",
        "discovery_url": "https://unratified.org/.well-known/agent-card.json",
        "repo": "safety-quotient-lab/unratified"
      },
      {
        "agent_id": "psychology-agent",
        "repo": "safety-quotient-lab/psychology-agent"
      },
      {
        "agent_id": "psq-agent",
        "repo": "safety-quotient-lab/safety-quotient"
      }
    ]
  },
  "extensions": [
    {
      "uri": "https://github.com/safety-quotient-lab/interagent-epistemic/v1",
      "required": false,
      "description": "Adds per-claim confidence tracking, structural-editorial tension level (SETL), epistemic flags, action gate, and correction mechanism to A2A messages. Jointly derived by observatory-agent and psychology-agent."
    }
  ],
  "skills": [
    {
      "id": "query-corpus-signals",
      "name": "Query Corpus Signals",
      "description": "Returns corpus-wide aggregate signals: transparency disclosure rates (author identified, conflicts, funding), accessibility (jargon density, assumed knowledge), persuasion technique distribution, temporal framing (retrospective/present/prospective), and overall HRCB signal overview.",
      "tags": [
        "human-rights",
        "transparency",
        "accessibility",
        "corpus-analytics",
        "udhr"
      ],
      "examples": [
        "What percentage of HN stories identify their author?",
        "How much persuasion content appears in HN tech coverage?",
        "What is the jargon density distribution across evaluated stories?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "rateLimit": "200 requests/hour per IP"
    },
    {
      "id": "query-stories",
      "name": "Query Evaluated Stories",
      "description": "Returns Hacker News stories with HRCB scores. Filterable by UDHR article (0\u201330), score direction (positive/negative/neutral), domain, content type, propaganda technique, jargon level, and temporal framing. Sorted by HRCB score, HN score, or recency.",
      "tags": [
        "human-rights",
        "hacker-news",
        "hrcb-scores",
        "udhr-provisions",
        "filtering"
      ],
      "examples": [
        "Show me the most privacy-negative stories this week",
        "Which stories touch Article 19 (freedom of expression)?",
        "Find stories flagged for propaganda techniques"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "rateLimit": "200 requests/hour per IP"
    },
    {
      "id": "query-domain-profile",
      "name": "Query Domain Rights Profile",
      "description": "Returns a domain's aggregate HRCB score, signal fingerprint (transparency, accessibility, persuasion), editorial character, and SETL tension level across all evaluated stories from that domain.",
      "tags": [
        "human-rights",
        "domain-analysis",
        "media-bias",
        "source-intelligence",
        "udhr"
      ],
      "examples": [
        "What is github.com's human rights alignment score?",
        "Which news domains score highest on transparency signals?",
        "Does techcrunch.com say one thing and do another (SETL)?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "rateLimit": "200 requests/hour per IP"
    },
    {
      "id": "query-udhr-article-rankings",
      "name": "Query UDHR Article Rankings",
      "description": "Returns all 31 UDHR provisions with per-article aggregate scores \u2014 editorial/structural channel averages, story counts, trigger counts, evidence distribution, SETL tension, and standard deviation. GET /api/v1/articles. Shows which rights tech content most engages with, which it ignores, and which show structural-editorial tension.",
      "tags": [
        "human-rights",
        "udhr",
        "rights-ranking",
        "corpus-analytics",
        "pedagogy"
      ],
      "examples": [
        "Which UDHR articles appear most in tech news?",
        "What rights does HN content lean most negative on?",
        "Which provisions show the most say-vs-do tension?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": "/api/v1/articles",
      "rateLimit": "200 requests/hour per IP"
    },
    {
      "id": "get-domain-badge",
      "name": "Get Domain Rights Badge",
      "description": "Returns an embeddable SVG badge showing a domain's HRCB score with color-coded scale. Suitable for README files, websites, and reports.",
      "tags": [
        "human-rights",
        "badge",
        "svg",
        "domain-score"
      ],
      "examples": [
        "Get a rights score badge for anthropic.com",
        "Embed an HRCB badge for my site"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "image/svg+xml"
      ],
      "rateLimit": "200 requests/hour per IP"
    },
    {
      "id": "receive-agent-proposals",
      "name": "Receive Inter-Agent Proposals",
      "description": "Observatory publishes pending proposals for data integration and cross-site collaboration via /.well-known/agent-inbox.json. Other agents (e.g., unratified.org) read and act on these at session start. Proposals follow status lifecycle: pending \u2192 accepted \u2192 implemented.",
      "tags": [
        "inter-agent",
        "proposals",
        "collaboration",
        "a2a"
      ],
      "examples": [
        "Check what data integrations the observatory is proposing",
        "Has the observatory proposed any new signal integrations?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "rateLimit": "no limit (static file)"
    },
    {
      "id": "get-methodology",
      "name": "Get Evaluation Methodology",
      "description": "Returns the complete HRCB evaluation methodology as structured JSON \u2014 scoring dimensions, content type weights, evidence strength caps, SETL formula, consensus weighting, propaganda technique tiers, Fair Witness rules, and classification ranges. Available at /api/v1/methodology or /.well-known/methodology.json.",
      "tags": [
        "methodology",
        "scoring",
        "transparency",
        "machine-readable"
      ],
      "examples": [
        "What weights does the observatory use for editorial vs structural scores?",
        "How does the SETL tension formula work?",
        "What are the propaganda technique tiers and weights?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "rateLimit": "no limit (static/prerendered)"
    },
    {
      "id": "query-psq-signals",
      "name": "Query Psychological Safety Quotient",
      "description": "Returns PSQ (Psychological Safety Quotient) scores \u2014 an independent signal measuring reader psychoemotional safety on a 0-10 scale. Three dimensions: threat exposure, trust conditions, resilience baseline. Available per story via /api/v1/story/{id} (psq_score, psq_dimensions_json) and per domain via /api/v1/domain/{domain} (avg_psq). Status: experimental.",
      "tags": [
        "psq",
        "safety",
        "psychoemotional",
        "experimental"
      ],
      "examples": [
        "How psychologically safe is this domain's content to read?",
        "What is the PSQ score breakdown for this story?",
        "Which domains have the highest reader safety scores?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "rateLimit": "200 requests per hour per IP"
    }
  ]
}