x402agent/SolanaOS / skills/pumpfun-token-scanner
pumpfun-token-scanner
VerifiedScrapes pump.fun/board using Chrome browser automation to extract the top 100 trending Solana tokens and writes structured markdown for a trading agent to consume. Use this skill any time you need to: scan pump.fun for new tokens, refresh the pump.md token list, run the scheduled board scrape, collect Solana meme token data, or build/update a trading watchlist from pump.fun. Even if the user says something casual like "check pump" or "update the token list" or "what's trending on pump", use this skill. The output file path and format are configurable but default to /Users/8bit/solanaos/pump.md.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 26.5 KB |
| blocklist.json | config | 987 B |
| scripts/blocklist_filter.py | script | 2.6 KB |
| scripts/deploy_pipeline.py | script | 9.5 KB |
| scripts/honcho_memory.py | script | 11.2 KB |
| scripts/push_to_convex.pyexecutable | script | 3.7 KB |
| scripts/push_to_convex.py.bakexecutable | script | 3.7 KB |
| scripts/send_telegram.pyexecutable | script | 10.4 KB |
| scripts/send_tweet.py | script | 5.6 KB |
| scripts/watch_pump.shexecutable | script | 2.5 KB |
scripts/push_to_convex.py
View on GitHub#!/usr/bin/env python3
"""
push_to_convex.py — Pushes pump.md scanner data to the nanohub Convex backend.
Reads pump.md, parses the pipe-delimited token table, and POSTs it to the
Convex HTTP endpoint at /solanaos/tracker/pump-ingest.
Usage:
python3 push_to_convex.py [--source browser|cli|remote-trigger]
The CONVEX_SITE_URL is read from (in order):
1. /Users/8bit/solanaos/nanohub/.env.local
2. Environment variable CONVEX_SITE_URL
3. Fallback: https://artful-frog-940.convex.site
"""
import json
import os
import re
import sys
import time
from pathlib import Path
from urllib.request import Request, urlopen
from urllib.error import URLError
PUMP_MD = os.path.expanduser("/Users/8bit/solanaos/pump.md")
ENV_LOCAL = os.path.expanduser("/Users/8bit/solanaos/nanohub/.env.local")
FALLBACK_URL = "https://artful-frog-940.convex.site"
def load_env_val(key: str) -> str | None:
"""Read a key=value from .env.local."""
if not os.path.isfile(ENV_LOCAL):
return None
with open(ENV_LOCAL) as f:
for line in f:
line = line.strip()
if line.startswith(f"{key}="):
return line.split("=", 1)[1].strip().strip('"').strip("'")
return None
def get_convex_url() -> str:
"""Resolve the Convex site URL."""
url = (
load_env_val("CONVEX_SITE_URL")
or load_env_val("VITE_CONVEX_SITE_URL")
or os.environ.get("CONVEX_SITE_URL")
or FALLBACK_URL
)
return url.rstrip("/")
def parse_pump_md(path: str) -> list[dict]:
"""Parse pump.md pipe-delimited rows into token dicts."""
if not os.path.isfile(path):
print(f"ERROR: {path} not found")
sys.exit(1)
tokens = []
with open(path, encoding="utf-8") as f:
for line in f:
# Match data rows: "| 1 | Name | SYM | `mint` | $5K | 3m ago | 45% |"
m = re.match(r"^\|\s*(\d+)\s*\|", line)
if not m:
continue
parts = [c.strip().strip("`") for c in line.strip().strip("|").split("|")]
if len(parts) < 7:
continue
idx, name, sym, mint, mc_raw, age_raw, pct_raw = parts[:7]
tokens.append(f"{idx}|{name}|{sym}|{mint}|{mc_raw}|{age_raw}|{pct_raw}")
return tokens
def main():
source = "browser"
for arg in sys.argv[1:]:
if arg.startswith("--source"):
if "=" in arg:
source = arg.split("=", 1)[1]
else:
idx = sys.argv.index(arg)
if idx + 1 < len(sys.argv):
source = sys.argv[idx + 1]
rows = parse_pump_md(PUMP_MD)
if not rows:
print("ERROR: No token rows found in pump.md")
sys.exit(1)
print(f"Parsed {len(rows)} tokens from pump.md")
convex_url = get_convex_url()
endpoint = f"{convex_url}/solanaos/tracker/pump-ingest"
payload = json.dumps({
"source": source,
"raw": "\n".join(rows),
"scannedAt": int(time.time() * 1000),
}).encode("utf-8")
req = Request(
endpoint,
data=payload,
headers={"Content-Type": "application/json"},
method="POST",
)
try:
with urlopen(req, timeout=15) as resp:
body = json.loads(resp.read())
print(f"✅ Pushed to Convex: {body.get('tokenCount', '?')} tokens")
if body.get("tiers"):
t = body["tiers"]
print(f" Fresh: {t.get('freshSniper',0)} | Graduating: {t.get('nearGraduation',0)} | "
f"Micro: {t.get('microCap',0)} | Mid: {t.get('midCap',0)} | Large: {t.get('largeCap',0)}")
except URLError as e:
print(f"⚠️ Convex push failed: {e}")
sys.exit(1)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |