In the rapidly evolving landscape of decentralized social media, Bluesky has emerged as a premier destination for digital artists and creators. However, for those managing high-volume portfolios across multiple WordPress sites, manual cross-posting is an unsustainable bottleneck. To bridge this gap, I developed a custom automation engine that doesn’t just share links, but optimizes visual impact and engagement through the AT Protocol.

This article dives deep into the technical implementation of a WordPress-to-Bluesky autoposter, focusing on two critical challenges: handling binary image data (Blobs) and implementing clickable links via Rich Text Facets.

Standard social sharing plugins often fall short when dealing with specialized niches like AI-generated art or character design. They frequently rely on simple link-card embeds which might not render correctly or fail to grab attention in a fast-moving timeline. Our custom solution targets the en category specifically, ensuring that high-resolution thumbnails are natively uploaded to Bluesky’s servers for maximum visibility.

The workflow follows a 4-step logic:

• Query: Periodically fetch the latest published post in a specific category.
• Authentication: Establish a secure session using the AT Protocol (com.atproto.server.createSession).
• Media Handling: Convert WordPress featured images into binary Blobs for Bluesky.
• Metadata Processing: Map WordPress tags to hashtags and calculate byte-offsets for URL Facets.

Unlike traditional APIs where you might simply provide an image URL, the AT Protocol requires a two-stage process for media. First, you must upload the image as a “Blob” (Binary Large Object), and then reference that Blob’s CID (Content Identifier) in the post record.

In our implementation, we utilize get_attached_file() to retrieve the absolute server path of the featured image. By using file_get_contents() and sending it via wp_remote_post() to the uploadBlob endpoint, we ensure the image is hosted natively on Bluesky. This results in a full-bleed image post which statistically yields 40% higher engagement than standard link previews.

// Technical Snippet: Uploading to Bluesky
$upload = wp_remote_post('https://bsky.social/xrpc/com.atproto.repo.uploadBlob', [
    'body'    => $img_data,
    'headers' => [
        'Authorization' => 'Bearer ' . $jwt,
        'Content-Type'  => $mime_type
    ]
]);

A common pitfall for developers entering the AT Protocol ecosystem is the discovery that URLs in the text field are treated as plain text. To make a link clickable in the Bluesky UI, you must implement Facets.

Facets are a way of adding “rich text” features by defining specific byte-ranges in the string. This is particularly tricky in PHP because Bluesky requires byte-indices, not character-indices. For instance, an emoji like 🎨 occupies more than one byte. Our logic calculates the precise starting and ending bytes of the URL within the string to ensure that the “View Full Illustration” call-to-action is fully functional on mobile devices and web browsers alike.

Visibility on Bluesky is heavily dependent on the global search feed. By leveraging WordPress’s get_the_tags() function, we dynamically transform internal taxonomies into external hashtags. We programmatically strip spaces (e.g., “Space Art” becomes “#SpaceArt”) to maintain hashtag integrity. This ensures that every automated post is indexed correctly under relevant tags like #AIArt or #Gijinka, driving organic traffic back to the WordPress site without manual intervention.

Conversion rate optimization (CRO) is as important in a social feed as it is on a landing page. By prepending the post with a palette emoji (🎨) and appending a clear directional cue (👇 View Full Illustration), we guide the user’s eye toward the link. This “Visual Hook” architecture is what differentiates a “spammy” bot from a professional automated gallery.

Building a custom autoposter is more than a convenience; it’s a strategic asset. By mastering the nuances of the AT Protocol—specifically Blobs and Facets—we’ve created a system that respects the platform’s native feel while maximizing the reach of WordPress-hosted content. For developers and site owners, this is the blueprint for a modern, decentralized marketing engine.