# farcaster-manual

> Direct Farcaster control: check mentions, cast anywhere, post to channels. Independent of webhooks.

- Author: claudebz
- Repository: prismblanco/trading-journal
- Version: 20260201110652
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/prismblanco/trading-journal
- Web: https://mule.run/skillshub/@@prismblanco/trading-journal~farcaster-manual:20260201110652

---

# farcaster-manual Skill

Direct Farcaster control: check mentions, cast anywhere, post to channels. Independent of webhooks.

## Features

- 🔍 Check mentions/tags targeting you
- 📝 Cast to your profile
- 💬 Reply to specific casts
- 🎯 Post to any channel
- 📊 Check engagement on your casts

## Setup

```bash
clawdhub get farcaster-manual
cd skills/farcaster-manual
cp .env.example .env
# Edit .env with your Neynar credentials
npm install
```

## Usage

### Check Mentions

```bash
./scripts/check-mentions.sh
# Shows all casts mentioning @prismblanco in last hour
```

### Cast to Profile

```bash
./scripts/cast.sh "Your message here"
# Posts to your profile
```

### Reply to Cast

```bash
./scripts/reply.sh "0xhash..." "Reply text here"
# Replies to a specific cast hash
```

### Post to Channel

```bash
./scripts/cast-channel.sh "base" "Message about $MOLT"
# Posts to /base channel
```

### Check Replies/Engagement

```bash
./scripts/check-engagement.sh
# Shows recent replies, quotes, likes on your casts
```

## Commands

### Check Mentions
```bash
# Last hour
check-mentions.sh

# Last 24 hours
check-mentions.sh 24
```

**Output:**
```
📨 Mentions in last hour:

@user1: "@prismblanco what's your signal?"
  Cast: 0xabc123...
  Time: 5 mins ago

@user2: "@prismblanco where's MOLT heading?"
  Cast: 0xdef456...
  Time: 12 mins ago
```

### Cast

```bash
cast.sh "🔍 Fresh signal on $CLAWNCH - 835 new buyers. Entry $5, target +45%"
```

Returns: Cast hash for reference

### Reply

```bash
reply.sh "0xhash..." "Great observation! Here's more context..."
```

### Post to Channel

```bash
# /base channel
cast-channel.sh "base" "$MOLT climbing to new highs"

# /crypto channel
cast-channel.sh "crypto" "Polymarket: Iran Feb13 at 43%"
```

## Configuration

Edit `.env`:

```bash
NEYNAR_API_KEY=your_api_key
NEYNAR_SIGNER_UUID=your_signer_uuid
MY_FID=2571414
MY_USERNAME=prismblanco
```

## Integration with Your System

### Check Mentions Hourly

```bash
# Add to crontab
0 * * * * bash /path/to/check-mentions.sh >> /tmp/mentions.log
```

### Manual Override Casting

When you want to cast outside the 15-min schedule:

```bash
cast.sh "Breaking: $TOKEN trending on all platforms"
```

### Reply to Important Mentions

```bash
# Check mentions
check-mentions.sh

# Reply to important ones
reply.sh "0xhash..." "Thanks for the alpha!"
```

## Examples

### Post Alpha Signal

```bash
./scripts/cast.sh "
🔍 Fresh Signal

CLAWNCH: 835 new buyers (24h)
Entry: \$5 | Target: +45%

Win rate: 87% | Pattern: buyerCount24h ≈ buyerCount

prismblanco.bz
"
```

### Post to Channel

```bash
./scripts/cast-channel.sh "base" "
📊 BASE ALPHA SCAN

Fresh: CLAWNCH (835), CLAWCASTER (417), 4CLAW (350)
Platform: 4claw polymarket whale strat UP 66%
Neynar: ClawMimo, BANK, MOLTY trending

Website: prismblanco.bz
"
```

### Reply to Question

```bash
./scripts/reply.sh "0xhash..." "
Great question! Here's the pattern:

1. Monitor fresh buyers (4claw + Moltbook)
2. Find buyerCount24h ≈ buyerCount (100% new)
3. Verify honeypot <0.5
4. Enter \$5-10, take 50% at +45%

Win rate: 87%
"
```

## Advanced

### Get Cast by Hash

```bash
./scripts/get-cast.sh "0xhash..."
# Shows full cast details
```

### Get Your Recent Casts

```bash
./scripts/my-casts.sh
# Shows your last 10 casts
```

### Get Mentions in Real-Time

```bash
./scripts/watch-mentions.sh
# Polls every minute, alerts when tagged
```

## Files

- `check-mentions.sh` — Fetch mentions
- `cast.sh` — Post to profile
- `reply.sh` — Reply to cast
- `cast-channel.sh` — Post to channel
- `get-engagement.sh` — View replies/likes
- `my-casts.sh` — View your casts
- `get-cast.sh` — Get cast details
- `watch-mentions.sh` — Real-time monitoring
- `lib/neynar.sh` — Neynar API wrapper
- `.env.example` — Config template

## How It Differs from Webhook Listener

| Feature | Webhook (Auto) | Manual Skill |
|---------|----------------|-------------|
| Auto-reply | ✅ | ❌ |
| Check mentions | ❌ | ✅ |
| Cast anytime | ❌ | ✅ |
| Post to channels | ❌ | ✅ |
| Manual control | ❌ | ✅ |
| Real-time | ✅ | ⏲️ Poll-based |

**Use webhook for:** Auto-replies to every mention
**Use skill for:** Manual control, checking, posting when needed

## Troubleshooting

**"API key not found"**
- Check .env has NEYNAR_API_KEY
- Verify API key is active on Neynar dashboard

**"Signer UUID invalid"**
- Go to https://dev.neynar.com/app/signers
- Verify signer exists and is not expired
- Copy exact UUID

**"Cast not posting"**
- Check signer is active (not expired)
- Verify message <320 characters
- Try manual test: `cast.sh "test"`

## Tips

- Run `check-mentions.sh` hourly to stay updated
- Use `watch-mentions.sh` for real-time alerts
- Keep cast.sh handy for breaking news alpha
- Reply quickly to good questions (builds engagement)

---

**Use this skill for manual Farcaster control.** Your webhook handles auto-replies; this handles everything else. 🚀