···
+
# Script: setup-kagi-aggregator.sh
+
# Purpose: Complete setup script for Kagi News RSS aggregator
+
# This is a reference implementation showing automated setup for a specific aggregator.
+
# Other aggregator developers can use this as a template.
+
echo "================================================"
+
echo "Kagi News RSS Aggregator - Automated Setup"
+
echo "================================================"
+
# Configuration for Kagi aggregator
+
AGGREGATOR_NAME="kagi-news-bot"
+
DISPLAY_NAME="Kagi News RSS"
+
DESCRIPTION="Aggregates tech news from Kagi RSS feeds and posts to relevant communities"
+
SOURCE_URL="https://github.com/coves-social/kagi-aggregator"
+
# Check if config already exists
+
if [ -f "kagi-aggregator-config.env" ]; then
+
echo "Configuration file already exists. Loading existing configuration..."
+
source kagi-aggregator-config.env
+
SKIP_ACCOUNT_CREATION=true
+
SKIP_ACCOUNT_CREATION=false
+
# Get runtime configuration
+
if [ "$SKIP_ACCOUNT_CREATION" = false ]; then
+
read -p "Enter PDS URL (default: https://bsky.social): " PDS_URL
+
PDS_URL=${PDS_URL:-https://bsky.social}
+
read -p "Enter email for bot account: " EMAIL
+
read -sp "Enter password for bot account: " PASSWORD
+
HANDLE="$AGGREGATOR_NAME-$TIMESTAMP.bsky.social"
+
echo "Creating PDS account..."
+
RESPONSE=$(curl -s -X POST "$PDS_URL/xrpc/com.atproto.server.createAccount" \
+
-H "Content-Type: application/json" \
+
\"handle\": \"$HANDLE\",
+
\"password\": \"$PASSWORD\"
+
if echo "$RESPONSE" | jq -e '.error' > /dev/null 2>&1; then
+
echo "✗ Error creating account:"
+
echo "$RESPONSE" | jq '.'
+
DID=$(echo "$RESPONSE" | jq -r '.did')
+
ACCESS_JWT=$(echo "$RESPONSE" | jq -r '.accessJwt')
+
REFRESH_JWT=$(echo "$RESPONSE" | jq -r '.refreshJwt')
+
echo "✓ Account created: $DID"
+
cat > kagi-aggregator-config.env <<EOF
+
# Kagi Aggregator Configuration
+
AGGREGATOR_HANDLE="$HANDLE"
+
AGGREGATOR_PDS_URL="$PDS_URL"
+
AGGREGATOR_EMAIL="$EMAIL"
+
AGGREGATOR_PASSWORD="$PASSWORD"
+
AGGREGATOR_ACCESS_JWT="$ACCESS_JWT"
+
AGGREGATOR_REFRESH_JWT="$REFRESH_JWT"
+
echo "✓ Configuration saved to kagi-aggregator-config.env"
+
# Get domain and Coves instance
+
read -p "Enter aggregator domain (e.g., kagi-news.example.com): " DOMAIN
+
read -p "Enter Coves instance URL (default: https://api.coves.social): " COVES_URL
+
COVES_URL=${COVES_URL:-https://api.coves.social}
+
echo "Setting up .well-known/atproto-did..."
+
echo "$DID" > .well-known/atproto-did
+
echo "✓ Created .well-known/atproto-did"
+
echo "================================================"
+
echo "IMPORTANT: Manual Step Required"
+
echo "================================================"
+
echo "Upload the .well-known directory to your web server at:"
+
echo " https://$DOMAIN/.well-known/atproto-did"
+
read -p "Press Enter when the file is uploaded and accessible..."
+
echo "Verifying .well-known/atproto-did..."
+
WELLKNOWN_CONTENT=$(curl -s "https://$DOMAIN/.well-known/atproto-did" || echo "ERROR")
+
if [ "$WELLKNOWN_CONTENT" != "$DID" ]; then
+
echo "✗ Error: .well-known/atproto-did not accessible or contains wrong DID"
+
echo " Got: $WELLKNOWN_CONTENT"
+
echo "✓ .well-known/atproto-did verified"
+
echo "Registering with Coves instance..."
+
RESPONSE=$(curl -s -X POST "$COVES_URL/xrpc/social.coves.aggregator.register" \
+
-H "Content-Type: application/json" \
+
\"domain\": \"$DOMAIN\"
+
if echo "$RESPONSE" | jq -e '.error' > /dev/null 2>&1; then
+
echo "✗ Registration failed:"
+
echo "$RESPONSE" | jq '.'
+
echo "✓ Registered with Coves"
+
# Create service declaration
+
echo "Creating service declaration..."
+
SERVICE_RECORD=$(cat <<EOF
+
"\$type": "social.coves.aggregator.service",
+
"displayName": "$DISPLAY_NAME",
+
"description": "$DESCRIPTION",
+
"sourceUrl": "$SOURCE_URL",
+
"createdAt": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+
RESPONSE=$(curl -s -X POST "$PDS_URL/xrpc/com.atproto.repo.createRecord" \
+
-H "Authorization: Bearer $ACCESS_JWT" \
+
-H "Content-Type: application/json" \
+
\"collection\": \"social.coves.aggregator.service\",
+
\"record\": $SERVICE_RECORD
+
if echo "$RESPONSE" | jq -e '.error' > /dev/null 2>&1; then
+
echo "✗ Failed to create service declaration:"
+
echo "$RESPONSE" | jq '.'
+
RECORD_URI=$(echo "$RESPONSE" | jq -r '.uri')
+
echo "✓ Service declaration created: $RECORD_URI"
+
# Save final configuration
+
cat >> kagi-aggregator-config.env <<EOF
+
# Setup completed on $(date)
+
AGGREGATOR_DOMAIN="$DOMAIN"
+
COVES_INSTANCE_URL="$COVES_URL"
+
SERVICE_DECLARATION_URI="$RECORD_URI"
+
echo "================================================"
+
echo "✓ Kagi Aggregator Setup Complete!"
+
echo "================================================"
+
echo "Configuration saved to: kagi-aggregator-config.env"
+
echo "Your aggregator is now registered and ready to use."
+
echo "1. Start your aggregator bot: npm start (or appropriate command)"
+
echo "2. Community moderators can authorize your aggregator"
+
echo "3. Once authorized, your bot can start posting"
+
echo "See docs/aggregators/SETUP_GUIDE.md for more information"
bretton.dev