controld

# Control D DNS Management

Control D is a DNS filtering and privacy service. This skill enables full API access.

## Authentication

Store API token in environment variable or pass directly:
```bash
export CONTROLD_API_TOKEN="your-api-token"
```

Get your API token from: https://controld.com/dashboard (Account Settings > API)

**Token Types:**
- **Read** - View-only access to Profiles, Devices, and Analytics
- **Write** - View and modify data (create/modify/delete)

**Security Tip:** Restrict tokens by allowed IP addresses for automation hosts.

## API Reference

Base URL: `https://api.controld.com`
Auth: `Authorization: Bearer $CONTROLD_API_TOKEN`

### Profiles

DNS filtering profiles define blocking rules, filters, and service controls.

```bash
# List all profiles
curl -s -H "Authorization: Bearer $CONTROLD_API_TOKEN" \
  "https://api.controld.com/profiles" | jq '.body.profiles'

# Create profile
curl -s -X POST -H "Authorization: Bearer $CONTROLD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Profile"}' \
  "https://api.controld.com/profiles"

# Clone existing profile
curl -s -X POST -H "Authorization: Bearer $CONTROLD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Cloned Profile","clone_profile_id":"PROFILE_ID"}' \
  "https://api.controld.com/profiles"

# Update profile
curl -s -X PUT -H "Authorization: Bearer $CONTROLD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"New Name"}' \
  "https://api.controld.com/profiles/PROFILE_ID"

# Delete profile
curl -s -X DELETE -H "Authorization: Bearer $CONTROLD_API_TOKEN" \
  "https://api.controld.com/profiles/PROFILE_ID"
```

### Profile Options

```bash
# List available profile options
curl -s -H "Authorization: Bearer $CONTROLD_API_TOKEN" \
  "https://api.controld.com/profiles/options" | jq '.body.options'

# Update profile option (status: 1=enabled, 0=disabled)
curl -s -X PUT -H "Authorization: Bearer $CONTROLD_API_TOKEN" \
  -H "Content-Type: applicatio...

# Control D Skill for OpenClaw

An OpenClaw skill for managing Control D DNS filtering service via API.

## Features

- Full API coverage: profiles, devices, filters, services, rules
- Organization and billing management
- Mobile config generation
- Analytics and statistics

## Installation

Clone this repo to your OpenClaw skills folder:

```bash
cd ~/.openclaw/workspace/skills
git clone https://github.com/AustinGarrod/openclaw-skill-controld.git controld
```

Or copy the files manually to `~/.openclaw/workspace/skills/controld/`

## Configuration

Set your Control D API token:

```bash
export CONTROLD_API_TOKEN="your-api-token"
```

Get your token from: https://controld.com/dashboard (Account Settings > API)

## Usage

Once installed, the skill triggers when you mention Control D, DNS filtering, DNS blocking, or device DNS setup.

Examples:
- "Show my Control D profiles"
- "Add a custom DNS rule to block example.com"
- "List devices on my Control D account"

## License

MIT