Connect Ayrshare to Your AI Agent

Specify final text, target platforms, and media to validate a post before requesting publication.

Try a Ayrshare Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Ayrshare

Check a Post Before Publishing

Validate text, target platforms, and media without sending a post.

/oo Ayrshare: Validate this Ayrshare post “[post text]” for platforms [platforms] with media URLs [public media URLs]. Check length and payload validity; do not publish.

Publish a Specified Post

Publish final content to selected linked accounts and report platform results.

/oo Ayrshare: Publish this final Ayrshare post “[post text]” to [platforms] with media URLs [public media URLs]. Report the post ID and any per-platform errors.

Review a Published Post

Read analytics for a known post and summarize the recorded platform metrics.

/oo Ayrshare: Read Ayrshare analytics for post [post ID] on platforms [platforms]. Summarize the metrics and flag missing platform results.

Start Working with Ayrshare

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Ayrshare

Connect your Ayrshare API key and any required user profile key.
Connect Ayrshare →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

Linked social accounts in the selected Ayrshare profile.
Use final post text and public media URLs. Publication can succeed on some platforms and fail on others, so inspect per-platform results.

Ayrshare Tools

Ayrshare connects social accounts for posting. This integration validates payloads, publishes or schedules posts, and reads post history and analytics.

Post Validation

Check length, post validity, and whether a media URL is accessible.

Publishing and History

Publish or schedule posts and read their status and history.

Post Analytics

Read analytics for an identified post, optionally scoped to platforms.

11 tools

Get User Profile

Get Ayrshare account or user profile details, including linked social accounts and usage metadata.

ayrshare.get_user_profile

List Post History

List Ayrshare post history with optional filters for date range, status, type, and social platforms.

ayrshare.list_post_history

Publish Post

Publish or schedule a social media post through Ayrshare using a JSON-friendly first-pass field set.

ayrshare.publish_post

Get Post

Get one Ayrshare post by top-level Ayrshare post ID, including status and per-platform results.

ayrshare.get_post

Delete Post

Delete one or more Ayrshare posts, delete all pending scheduled posts, or mark a post as manually deleted.

ayrshare.delete_post

Update Post

Update mutable Ayrshare post metadata such as scheduleDate, approval status, notes, pause state, comments, or YouTube visibility.

ayrshare.update_post

Retry Post

Retry an Ayrshare post whose previous publish attempt failed, returning the new pending post status.

ayrshare.retry_post

Check Post Length

Check weighted social post length and platform validity using Ayrshare's post length validator.

ayrshare.check_post_length

Validate Post

Validate an Ayrshare post payload before publishing, including platform and media URL checks.

ayrshare.validate_post

Verify Media Url

Verify that a media URL exists and is accessible to Ayrshare.

ayrshare.verify_media_url

Get Post Analytics

Get real-time analytics for an Ayrshare post, optionally limited to selected social platforms.

ayrshare.get_post_analytics

Frequently Asked Questions

Can I schedule a post instead of publishing immediately?

Yes. Provide a schedule datetime with timezone and the final content and platforms. Check the returned status for the scheduled post.

What kind of media link should I provide?

Use a publicly accessible media URL. You can verify access before validating the post; platform-specific media requirements still apply.

What if only some platforms succeed?

Inspect per-platform post IDs and errors. Report the partial result before requesting a retry, rather than treating the whole publication as successful.