S
SkillNav

Instapy

by bytesagain3

šŸ“· Instagram Bot - Tool for automated Instagram interactions social-automator, python, automation, bot, clarifai, instagram.

View Chinese version with editor review

å®‰č£…

claude skill add --url github.com/openclaw/skills/tree/main/skills/bytesagain3/social-automator

ę–‡ę”£

Social Automator

Social Automator v2.0.0 ā€” a general-purpose utility toolkit for logging, tracking, and managing data entries from the command line. Each command records timestamped entries into its own log file and supports review of recent history.

Commands

The script (scripts/script.sh) exposes the following commands via a case dispatcher:

CommandDescription
run <input>Record a "run" entry. Without args, shows the 20 most recent run entries.
check <input>Record a "check" entry. Without args, lists recent check entries.
convert <input>Record a "convert" entry. Without args, lists recent convert entries.
analyze <input>Record an "analyze" entry. Without args, lists recent analyze entries.
generate <input>Record a "generate" entry. Without args, lists recent generate entries.
preview <input>Record a "preview" entry. Without args, lists recent preview entries.
batch <input>Record a "batch" entry. Without args, lists recent batch entries.
compare <input>Record a "compare" entry. Without args, lists recent compare entries.
export <input>Record an "export" entry. Without args, lists recent export entries.
config <input>Record a "config" entry. Without args, lists recent config entries.
status <input>Record a "status" entry. Without args, lists recent status entries.
report <input>Record a "report" entry. Without args, lists recent report entries.
statsShow summary statistics across all log files (entry counts per type, total, disk usage).
export <fmt>Export all data in json, csv, or txt format to $DATA_DIR/export.<fmt>.
search <term>Search all log files for a term (case-insensitive grep).
recentShow the 20 most recent lines from history.log.
statusHealth check ā€” shows version, data directory, total entries, disk usage, last activity.
helpDisplay the full help/usage message.
versionPrint social-automator v2.0.0.

Note: The export and status commands appear twice in the case statement. The first match (entry-logging form) takes precedence. The standalone _export and _status helper functions are reachable only if the entry-logging branches are bypassed.

How Each Entry Command Works

  1. If called without arguments, it tails the last 20 lines of <command>.log.
  2. If called with arguments, it:
    • Timestamps the input (YYYY-MM-DD HH:MM|<input>)
    • Appends it to $DATA_DIR/<command>.log
    • Prints confirmation with the current total count
    • Logs the action to history.log

Data Storage

All data is stored as plain-text log files under:

code
~/.local/share/social-automator/
ā”œā”€ā”€ run.log
ā”œā”€ā”€ check.log
ā”œā”€ā”€ convert.log
ā”œā”€ā”€ analyze.log
ā”œā”€ā”€ generate.log
ā”œā”€ā”€ preview.log
ā”œā”€ā”€ batch.log
ā”œā”€ā”€ compare.log
ā”œā”€ā”€ export.log
ā”œā”€ā”€ config.log
ā”œā”€ā”€ status.log
ā”œā”€ā”€ report.log
ā””ā”€ā”€ history.log          # unified activity log

Each log line uses pipe-delimited format: YYYY-MM-DD HH:MM|<value>

The history.log uses: MM-DD HH:MM <command>: <value>

Requirements

  • Bash 4.0+ (uses local variables, set -euo pipefail)
  • coreutils: date, wc, du, tail, cat, basename, grep, sed
  • No external dependencies, API keys, or network access required
  • Works on Linux and macOS

When to Use

  1. Quick data logging ā€” when you need a lightweight CLI to record timestamped entries without setting up a database
  2. Activity tracking ā€” log daily automation runs, checks, or social media operations and review them later with recent or search
  3. Batch processing records ā€” track batch job inputs and outputs for auditing purposes
  4. Data export ā€” pull all logged entries into JSON, CSV, or TXT for reporting or integration with other tools
  5. Health monitoring ā€” use stats and status to get a quick overview of how much data has been collected and current disk usage

Examples

Log a run entry and review history

bash
# Record an automation run
bash scripts/script.sh run "posted 5 images to feed"

# Check recent runs
bash scripts/script.sh run

Track and compare operations

bash
# Log a check
bash scripts/script.sh check "follower count 12345"

# Log a comparison
bash scripts/script.sh compare "engagement rate week-over-week"

Search across all logs

bash
bash scripts/script.sh search "follower"

Export everything as JSON

bash
bash scripts/script.sh export json
# Output: ~/.local/share/social-automator/export.json

View summary statistics

bash
bash scripts/script.sh stats
# Shows per-type counts, totals, and disk usage

Configuration

Set the DATA_DIR variable (or modify it in the script) to change the storage directory. Default: ~/.local/share/social-automator/

Output

All commands print to stdout. Redirect to a file as needed:

bash
bash scripts/script.sh stats > summary.txt

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com