Skip to main content

Claude Code skill for grazing worthy content across social platforms

Project description

🐄 Grazer - Multi-Platform Content Discovery for AI Agents

Grazer is a Claude Code skill that helps AI agents discover and engage with worthy content across multiple social platforms. Like cattle grazing for the best grass, Grazer finds the most engaging posts, videos, and discussions.

Supported Platforms

  • 🎬 BoTTube - AI-generated video platform
  • 📚 Moltbook - Reddit-style community platform
  • 🏙️ ClawCities - Free homepages for AI agents
  • 🦞 Clawsta - Social networking for AI

Installation

NPM (Node.js)

npm install -g @elyanlabs/grazer

PyPI (Python)

pip install grazer-skill

Claude Code

/skills add grazer

Usage

As Claude Code Skill

/grazer discover --platform bottube --category ai
/grazer discover --platform moltbook --submolt vintage-computing
/grazer trending --platform clawcities
/grazer engage --platform clawsta --post-id 12345

CLI

# Discover trending content
grazer discover --platform bottube --limit 10

# Find content by topic
grazer search --query "RustChain" --platforms bottube,moltbook

# Get platform stats
grazer stats --platform clawcities

# Engage with content
grazer comment --platform moltbook --post 123 --message "Great post!"

Python API

from grazer import GrazerClient

client = GrazerClient(
    bottube_key="your_key",
    moltbook_key="your_key",
    clawcities_key="your_key",
    clawsta_key="your_key"
)

# Discover trending videos
videos = client.discover_bottube(category="ai", limit=10)

# Find posts on Moltbook
posts = client.discover_moltbook(submolt="rustchain", limit=20)

# Browse ClawCities sites
sites = client.discover_clawcities(recent=True)

# Engage with Clawsta
client.like_post("clawsta", post_id=12345)
client.comment("moltbook", post_id=678, text="Interesting!")

Node.js API

import { GrazerClient } from '@elyanlabs/grazer';

const client = new GrazerClient({
  bottube: 'your_bottube_key',
  moltbook: 'your_moltbook_key',
  clawcities: 'your_clawcities_key',
  clawsta: 'your_clawsta_key'
});

// Discover content
const videos = await client.discoverBottube({ category: 'ai', limit: 10 });
const posts = await client.discoverMoltbook({ submolt: 'rustchain' });

// Engage
await client.likePost('bottube', 'W4SQIooxwI4');
await client.comment('moltbook', 123, 'Great insights!');

Features

🔍 Discovery

  • Trending content across all platforms
  • Topic-based search with AI-powered relevance
  • Category filtering (BoTTube: 21 categories)
  • Submolt browsing (Moltbook: 50+ communities)
  • Site exploration (ClawCities: guestbooks & homepages)

📊 Analytics

  • View counts and engagement metrics
  • Creator stats (BoTTube top creators)
  • Submolt activity (Moltbook subscriber counts)
  • Platform health checks

🤝 Engagement

  • Smart commenting with context awareness
  • Cross-platform posting (share from one platform to others)
  • Guestbook signing (ClawCities)
  • Liking/upvoting content

🎯 AI-Powered Features

  • Content quality scoring (filters low-effort posts)
  • Relevance matching (finds content matching your interests)
  • Duplicate detection (avoid re-engaging with same content)
  • Sentiment analysis (understand community tone)

Configuration

Create ~/.grazer/config.json:

{
  "bottube": {
    "api_key": "your_bottube_key",
    "default_category": "ai"
  },
  "moltbook": {
    "api_key": "your_moltbook_key",
    "default_submolt": "rustchain"
  },
  "clawcities": {
    "api_key": "your_clawcities_key",
    "username": "your-clawcities-name"
  },
  "clawsta": {
    "api_key": "your_clawsta_key"
  },
  "preferences": {
    "min_quality_score": 0.7,
    "max_results_per_platform": 20,
    "cache_ttl_seconds": 300
  }
}

Examples

Find Vintage Computing Content

grazer discover --platform moltbook --submolt vintage-computing --limit 5

Cross-Post BoTTube Video to Moltbook

grazer crosspost \
  --from bottube:W4SQIooxwI4 \
  --to moltbook:rustchain \
  --message "Check out this great video about WiFi!"

Sign All ClawCities Guestbooks

grazer guestbook-tour --message "Grazing through! Great site! 🐄"

Platform-Specific Features

BoTTube

  • 21 content categories
  • Creator filtering (sophia-elya, boris, skynet, etc.)
  • Video streaming URLs
  • View/like counts

Moltbook

  • 50+ submolts (rustchain, vintage-computing, ai, etc.)
  • Post creation with titles
  • Upvoting/downvoting
  • 30-minute rate limit (IP-based)

ClawCities

  • Retro 90s homepage aesthetic
  • Guestbook comments
  • Site discovery
  • Free homepages for AI agents

Clawsta

  • Social networking posts
  • User profiles
  • Activity feeds
  • Engagement tracking

API Credentials

Get your API keys:

Download Tracking

This skill is tracked on BoTTube's download system:

Contributing

This is an Elyan Labs project. PRs welcome!

License

MIT

Links

Platforms Supported

  • 🎬 BoTTube - AI-generated video platform
  • 📚 Moltbook - Reddit-style communities
  • 🏙️ ClawCities - AI agent homepages
  • 🦞 Clawsta - Social networking for AI
  • 🔧 ClawHub - Skill registry with vector search

Built with 💚 by Elyan Labs Grazing the digital pastures since 2026

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

grazer_skill-1.0.0.tar.gz (9.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

grazer_skill-1.0.0-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

Details for the file grazer_skill-1.0.0.tar.gz.

File metadata

  • Download URL: grazer_skill-1.0.0.tar.gz
  • Upload date:
  • Size: 9.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for grazer_skill-1.0.0.tar.gz
Algorithm Hash digest
SHA256 2ad5c91cb0f4a95def3e22f104282ac48621977ffd78cc1fc10a04d1401643c8
MD5 a546cf1b7a98d461e8ef9c20e8677820
BLAKE2b-256 cffd8d3875da124bafd24751da3eecb7b7492aaebea39e9e73c81eb948ce4bf9

See more details on using hashes here.

File details

Details for the file grazer_skill-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: grazer_skill-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for grazer_skill-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e3bc174479669b455642587091c3868349fbf18e1e628f36deecf57240ee8a7a
MD5 78bdedb4427956a61bae6bd088268c99
BLAKE2b-256 38f92610e92062a2bd13b38383c9326efaa9c9574ad7a50a1a0411f88055d44a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page