Post images, links or text to Reddit through a script-app login, and walk a JSON queue of scheduled posts without ever reposting the same title twice.
The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.
Jump to:
check_loginpostpost_from_json
check_login
Verify the stored Reddit credentials work by calling praw's authenticated user.me(), without posting anything.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
profile |
profile |
optional, default reddit
|
| Name | Type | Notes |
|---|---|---|
ok |
bool | |
username |
string | |
link_karma |
int | |
comment_karma |
int |
post
Destructive
Submit one post to a subreddit: a local image file (uploaded), an http(s) URL (link post), or plain text (self post) when image_or_url is left blank. Skips silently if this exact subreddit+title was already posted.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
subreddit |
string | required | |
title |
string | required | |
image_or_url |
string |
optional, default ""
|
|
text |
text |
optional, default ""
|
|
flair |
string |
optional, default ""
|
|
profile |
profile |
optional, default reddit
|
| Name | Type | Notes |
|---|---|---|
posted |
bool | |
skipped |
bool | |
id |
string | |
url |
string | |
subreddit |
string | |
kind |
string |
post_from_json
Destructive
Walk a JSON file of scheduled posts ([{title, text|subject, subreddit?, image_or_url?, flair?}, ...]), submitting each entry not already recorded in the posted-history marker, waiting a delay between posts.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
file |
path | required | |
subreddit |
string |
optional, default ""
|
|
flair |
string |
optional, default ""
|
|
delay_seconds |
float |
optional, default 30
|
|
limit |
int |
optional, default 0
|
|
profile |
profile |
optional, default reddit
|
| Name | Type | Notes |
|---|---|---|
count |
int | |
failed |
int | |
skipped |
int | |
posted |
json |
python app.py --action check_login --params '{}'Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("reddit-poster", "check_login", {}){
"id": "n0",
"app": "reddit-poster",
"action": "check_login",
"params": {},
"inputs": {}
}python app.py --action post --params '{"subreddit": "<subreddit>", "title": "<title>"}'
# preview first - destructive action, nothing is changed:
python app.py --action post --params '{"subreddit": "<subreddit>", "title": "<title>"}' --dry-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("reddit-poster", "post", {"subreddit": "<subreddit>", "title": "<title>"})
# preview first:
run_action("reddit-poster", "post", {"subreddit": "<subreddit>", "title": "<title>"}, dry_run=true){
"id": "n0",
"app": "reddit-poster",
"action": "post",
"params": {
"subreddit": "<subreddit>",
"title": "<title>"
},
"inputs": {}
}python app.py --action post_from_json --params '{"file": "D:/path/to/file"}'
# preview first - destructive action, nothing is changed:
python app.py --action post_from_json --params '{"file": "D:/path/to/file"}' --dry-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("reddit-poster", "post_from_json", {"file": "D:/path/to/file"})
# preview first:
run_action("reddit-poster", "post_from_json", {"file": "D:/path/to/file"}, dry_run=true){
"id": "n0",
"app": "reddit-poster",
"action": "post_from_json",
"params": {
"file": "D:/path/to/file"
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.