@gurupanguji

Social Automation: X (Twitter) & Nostr Integration Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Extend the social media automation suite by adding X (Twitter) and Nostr integration.

Architecture:

• X (Twitter): Use the tweepy library to interact with X API v2. Media uploads will utilize the v1.1 endpoint (as required by X for media IDs) before posting the tweet via v2.
• Nostr: Use the nostr-sdk library to publish Kind 1 (text) notes to a set of default relays.
• Fallbacks: Both platforms will use the “Twitter” snippet from the markdown files if a specific “X” or “Nostr” section is missing.
• Manual Execution: The workflow will be configured for workflow_dispatch only during the integration phase.

Tech Stack: Python 3.x, tweepy, nostr-sdk, requests, GitHub Actions, GitHub Secrets.

---

File Map

Modify

• scripts/publish_social.py Responsibility: Add publish_x and publish_nostr functions. Update main loop and platform filtering.
• .github/workflows/publish_social.yml Responsibility: Map new secrets for X and Nostr. Update platform input options.
• requirements.txt Responsibility: Add tweepy and nostr-sdk dependencies.

Implementation Tasks

Task 1: X (Twitter) Integration

• Step 1: Update dependencies
  • Add tweepy to requirements.txt.
• Step 2: Implement publish_x in scripts/publish_social.py
  • Use tweepy.Client for v2 posting.
  • Use tweepy.API (OAuth 1.0a) for media uploads.
  • Snippet priority: “X” -> “Twitter”.
• Step 3: Update .github/workflows/publish_social.yml
  • Add X_CONSUMER_KEY, X_CONSUMER_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET to env.
  • Update platform description to include “X”.
• Step 4: Commit & Verification
  • Commit as “feat: Add X (Twitter) social publishing integration”.
  • Verify with manual workflow_dispatch using --platform X.

Task 2: Nostr Integration

• Step 1: Update dependencies
  • Add nostr-sdk to requirements.txt.
• Step 2: Implement publish_nostr in scripts/publish_social.py
  • Use nostr_sdk (async).
  • Connect to wss://relay.damus.io and wss://nos.lol.
  • Snippet priority: “Nostr” -> “Twitter”.
• Step 3: Update .github/workflows/publish_social.yml
  • Add NOSTR_PRIVATE_KEY to env.
  • Update platform description to include “Nostr”.
• Step 4: Commit & Verification
  • Commit as “feat: Add Nostr social publishing integration”.
  • Verify with manual workflow_dispatch using --platform Nostr.

Task 3: Final Documentation

• Step 1: Update README.md and AGENTS.md
  • Include X and Nostr in the list of supported platforms.