mirror of https://github.com/Significant-Gravitas/AutoGPT.git synced 2026-04-30 03:00:41 -04:00

Files

Nicholas Tindle c1a1767034 feat(docs): Add block documentation auto-generation system (#11707 )

- Add generate_block_docs.py script that introspects block code to
generate markdown
- Support manual content preservation via <!-- MANUAL: --> markers
- Add migrate_block_docs.py to preserve existing manual content from git
HEAD
- Add CI workflow (docs-block-sync.yml) to fail if docs drift from code
- Add Claude PR review workflow (docs-claude-review.yml) for doc changes
- Add manual LLM enhancement workflow (docs-enhance.yml)
- Add GitBook configuration (.gitbook.yaml, SUMMARY.md)
- Fix non-deterministic category ordering (categories is a set)
- Add comprehensive test suite (32 tests)
- Generate docs for 444 blocks with 66 preserved manual sections

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

<!-- Clearly explain the need for these changes: -->

### Changes 🏗️

<!-- Concisely describe all of the changes made in this pull request:
-->

### Checklist 📋

#### For code changes:
- [x] I have clearly listed my changes in the PR description
- [x] I have made a test plan
- [x] I have tested my changes according to the test plan:
  <!-- Put your test plan here: -->
  - [x] Extensively test code generation for the docs pages



<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Introduces an automated documentation pipeline for blocks and
integrates it into CI.
> 
> - Adds `scripts/generate_block_docs.py` (+ tests) to introspect blocks
and generate `docs/integrations/**`, preserving `<!-- MANUAL: -->`
sections
> - New CI workflows: **docs-block-sync** (fails if docs drift),
**docs-claude-review** (AI review for block/docs PRs), and
**docs-enhance** (optional LLM improvements)
> - Updates existing Claude workflows to use `CLAUDE_CODE_OAUTH_TOKEN`
instead of `ANTHROPIC_API_KEY`
> - Improves numerous block descriptions/typos and links across backend
blocks to standardize docs output
> - Commits initial generated docs including
`docs/integrations/README.md` and many provider/category pages
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
631e53e0f6. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-19 07:03:19 +00:00

2.2 KiB

Raw Blame History

Ayrshare Post To Reddit

Blocks for posting content to Reddit using the Ayrshare social media management API.

Post To Reddit

What it is

Post to Reddit using Ayrshare

How it works

This block uses Ayrshare's API to publish content to Reddit. It supports text posts, image posts, and video submissions with optional scheduling and link shortening features.

The block authenticates through Ayrshare and submits content to your connected Reddit account. Common options include approval workflows for content review before publishing, random content generation, and Unsplash integration for sourcing images.

Inputs

Input	Description	Type	Required
post	The post text to be published	str	No
media_urls	Optional list of media URLs to include. Set is_video in advanced settings to true if you want to upload videos.	List[str]	No
is_video	Whether the media is a video	bool	No
schedule_date	UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ)	str (date-time)	No
disable_comments	Whether to disable comments	bool	No
shorten_links	Whether to shorten links	bool	No
unsplash	Unsplash image configuration	str	No
requires_approval	Whether to enable approval workflow	bool	No
random_post	Whether to generate random post text	bool	No
random_media_url	Whether to generate random media	bool	No
notes	Additional notes for the post	str	No

Outputs

Output	Description	Type
error	Error message if the operation failed	str
post_result	The result of the post	PostResponse
post	The result of the post	PostIds

Possible use case

Community Engagement: Share relevant content to niche subreddits as part of community marketing strategies.

Content Distribution: Cross-post blog articles or announcements to relevant Reddit communities for broader reach.

Brand Monitoring Response: Automatically share updates or responses in communities where your brand is discussed.

2.2 KiB Raw Blame History