reddit

Original：🇺🇸 English

Translated

Submit posts (link or text) to subreddits and read your Reddit identity / content via the Reddit API. Use when the user mentions Reddit, posting to a subreddit, submitting a link or self-post, or checking their Reddit profile / submissions.

12installs

Sourceacedatacloud/skills

Added on2026-07-04

NPX Install

npx skill4agent add acedatacloud/skills reddit

SKILL.md Content

View Translation Comparison →

Call the Reddit API (OAuth endpoints) with

curl + jq

. The user's bearer token is in

$REDDIT_TOKEN

. Every call MUST send a
User-Agent
header or Reddit returns

. Use the OAuth host

https://oauth.reddit.com

.

bash

UA="web:cloud.acedata.connectors:v1.0 (by /u/acedatacloud)"

Errors are JSON; a submit returns

{"json":{"errors":[...], "data":{...}}}

— if

errors

is non-empty, show them verbatim.

→ token expired, re-connect.

Always start by confirming identity:

bash

curl -sS -H "Authorization: Bearer $REDDIT_TOKEN" -H "User-Agent: $UA" \
  "https://oauth.reddit.com/api/v1/me" | jq '{name, total_karma, link_karma}'

Submit a post

Confirm the subreddit + title + body with the user first.

sr

is the subreddit name WITHOUT the

r/

prefix.

bash

# Self (text) post: kind=self + text. Link post: kind=link + url.
curl -sS -X POST "https://oauth.reddit.com/api/submit" \
  -H "Authorization: Bearer $REDDIT_TOKEN" -H "User-Agent: $UA" \
  --data-urlencode "sr=test" \
  --data-urlencode "kind=self" \
  --data-urlencode "title=My title" \
  --data-urlencode "text=My self-post body in markdown" \
  --data-urlencode "api_type=json" \
  | jq '.json | {errors, url: .data.url, id: .data.id}'

For a link post:

bash

curl -sS -X POST "https://oauth.reddit.com/api/submit" \
  -H "Authorization: Bearer $REDDIT_TOKEN" -H "User-Agent: $UA" \
  --data-urlencode "sr=test" --data-urlencode "kind=link" \
  --data-urlencode "title=My title" --data-urlencode "url=https://example.com" \
  --data-urlencode "api_type=json" | jq '.json'

Read my submissions

bash

curl -sS -H "Authorization: Bearer $REDDIT_TOKEN" -H "User-Agent: $UA" \
  "https://oauth.reddit.com/user/USERNAME/submitted?limit=10" \
  | jq '.data.children[] | .data | {title, subreddit, ups, num_comments, permalink}'

Gotchas

User-Agent is mandatory on every request — omitting it →
```
429
```
.
Many subreddits gate posting on account age / karma / flair; a submit can return
```
errors
```
like
```
[["SUBREDDIT_NOTALLOWED", ...]]
```
— surface it and try
```
r/test
```
to validate the flow.
Respect rate limits: read the
```
X-Ratelimit-Remaining
```
response header; space out bulk submits.
Use
```
r/test
```
as a safe target when validating that the connection works.

Record the output

After you successfully publish and obtain the live result URL, call the built-in

publish_artifact

tool ONCE so the user can track this deliverable in My Outputs:

publish_artifact(kind="message", channel="reddit", title="<title>", url="<the REAL returned URL>", status="delivered")

Use the real returned URL — never fabricate one. Call it once per published item, only after delivery is confirmed; skip it (or use

status="failed"

) if publishing failed. See

_shared/artifacts.md

.

reddit

NPX Install

Tags

SKILL.md Content

Submit a post

Read my submissions

Gotchas

Record the output