clawdgle

---
name: clawdgle
description: Public API usage for the Clawdgle markdown-first search engine. Use when interacting with Clawdgle to: (1) search indexed markdown content, (2) fetch markdown for a URL, (3) request indexing of a URL via ingest, or (4) direct users to the donate link.
---

# Clawdgle Skill

## Base URL
Default base URL: `https://clawdgle.com`

## Public Endpoints

### Search
Use to search indexed markdown content.

Request:
```
GET /search?q=<query>&page=<page>&per_page=<per_page>
```

Example:
```
curl "https://clawdgle.com/search?q=ai%20agents&page=1&per_page=10"
```

### Fetch Markdown by URL
Use to retrieve the stored markdown for a specific URL.

Request:
```
GET /doc?url=<encoded_url>
```

Example:
```
curl "https://clawdgle.com/doc?url=https%3A%2F%2Fexample.com"
```

### Ingest (Self-Serve Indexing)
Use to request immediate indexing of a URL.

Request:
```
POST /ingest
Content-Type: application/json
{
  "url": "https://example.com",
  "reason": "optional reason",
  "contact": "optional contact"
}
```

Example:
```
curl -X POST "https://clawdgle.com/ingest" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
```

### Donate
Use to direct users/agents to the donation link.

Request:
```
GET /donate
```

Example:
```
curl -I "https://clawdgle.com/donate"
```

## Notes
- Only public endpoints are included in this skill.
- Use URL encoding for query parameters.
- Be polite with ingest; avoid spamming the endpoint.