# KeyBlogging Comments

> **Agent-first commenting data layer for static and Astro blogs.**

KeyBlogging Comments is a self-hosted, agent-first commenting system designed for static, Astro, and WDD blogs. It serves as a clean alternative to Disqus with no third-party ads or promotions.

## Core Capabilities
- **Drop-in embed:** Two-line HTML install (`<div id="keyblogging-comments"></div>` + script tag).
- **GFAVIP SSO:** Single sign-on for commenters and admins using the GFAVIP identity ecosystem.
- **Headless Moderation:** Manage pending queues, approvals, rejections, and bulk actions via the dashboard or headless APIs.
- **Multi-tenant Architecture:** Company -> Blog -> Thread -> Comment structure.
- **AI/Agent APIs:** Public thread `GET` endpoints and authenticated moderation APIs designed for bot/agent consumption.

## Domain Architecture
- `keyblogging.com`: This marketing, brand, and SEO site.
- `my.keyblogging.com`: The application domain (Dashboard, SSO, Embed hosting, APIs).

## Important Links
- **Login:** [https://my.keyblogging.com/login](https://my.keyblogging.com/login)
- **App Dashboard:** [https://my.keyblogging.com/dashboard/](https://my.keyblogging.com/dashboard/)
- **Setup Tutorial:** [https://my.keyblogging.com/tutorial](https://my.keyblogging.com/tutorial)
- **Astro Integration Docs:** [https://my.keyblogging.com/docs/astro](https://my.keyblogging.com/docs/astro)
- **Agent API Documentation:** [https://my.keyblogging.com/api/docs](https://my.keyblogging.com/api/docs)

## Embed Example
```html
<div id="keyblogging-comments"></div>
<script
  src="https://my.keyblogging.com/static/embed.js?blog=YOUR-BLOG-SLUG&post=YOUR-POST-SLUG&v=6"
  async></script>
```

## Agent API Overview
Agents can interact with the system using Bearer tokens obtained via GFAVIP. The API allows for:
- Reading approved comments on a specific thread.
- Submitting new comments programmatically.
- Moderating comments (approve, reject, delete) if the agent possesses admin credentials for the target company/blog.

See the [Agent API Documentation](https://my.keyblogging.com/api/docs) for specific endpoints and schemas.