Bluesky Facet Generator

// npm install @atproto/api
import { AtpAgent, RichText } from '@atproto/api'

const agent = new AtpAgent({ service: 'https://bsky.social' })
await agent.login({
  identifier: 'yourname.bsky.social',
  password: process.env.BLUESKY_APP_PASSWORD!,
})

const rt = new RichText({
  text: 'Shipped v2 🚀 notes at https://example.com/changelog thanks @bsky.app #buildinpublic',
})
// Finds links, mentions and tags, computes UTF-8 offsets, resolves each handle to a DID
await rt.detectFacets(agent)

// A handle that did not resolve keeps an empty did. Drop it so the record stays valid.
const facets = rt.facets?.filter((f) =>
  f.features.every((ft) => ft.$type !== 'app.bsky.richtext.facet#mention' || (ft as { did: string }).did)
)

await agent.post({
  text: rt.text,
  facets,
  langs: ['en'],
  createdAt: new Date().toISOString(),
})

# pip install requests
import os
import re
from datetime import datetime, timezone

import requests


def resolve(handle):
    r = requests.get(
        "https://public.api.bsky.app/xrpc/com.atproto.identity.resolveHandle",
        params={"handle": handle},
    )
    return r.json().get("did") if r.ok else None


def build_facets(text):
    data = text.encode("utf-8")  # offsets are positions in these bytes
    facets = []
    for m in re.finditer(rb"https?://\S+", data):
        uri = m.group(0).rstrip(b".,;:!?")
        facets.append({
            "index": {"byteStart": m.start(), "byteEnd": m.start() + len(uri)},
            "features": [{"$type": "app.bsky.richtext.facet#link", "uri": uri.decode()}],
        })
    for m in re.finditer(rb"(?:^|\s)(@([a-zA-Z0-9.-]+))", data):
        handle = m.group(2).rstrip(b".")
        did = resolve(handle.decode())
        if did:
            facets.append({
                "index": {"byteStart": m.start(1), "byteEnd": m.start(1) + 1 + len(handle)},
                "features": [{"$type": "app.bsky.richtext.facet#mention", "did": did}],
            })
    for m in re.finditer(rb"(?:^|\s)(#[^\s#]+)", data):
        tag = m.group(1).rstrip(b".,;:!?")
        if len(tag) > 1:
            facets.append({
                "index": {"byteStart": m.start(1), "byteEnd": m.start(1) + len(tag)},
                "features": [{"$type": "app.bsky.richtext.facet#tag", "tag": tag[1:].decode()}],
            })
    return sorted(facets, key=lambda f: f["index"]["byteStart"])


text = "Shipped v2 🚀 notes at https://example.com/changelog thanks @bsky.app #buildinpublic"
session = requests.post(
    "https://bsky.social/xrpc/com.atproto.server.createSession",
    json={"identifier": "yourname.bsky.social", "password": os.environ["BLUESKY_APP_PASSWORD"]},
).json()
record = {
    "$type": "app.bsky.feed.post",
    "text": text,
    "facets": build_facets(text),
    "createdAt": datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
    "langs": ["en"],
}
r = requests.post(
    "https://bsky.social/xrpc/com.atproto.repo.createRecord",
    headers={"Authorization": f"Bearer {session['accessJwt']}"},
    json={"repo": session["did"], "collection": "app.bsky.feed.post", "record": record},
)
print(r.status_code, r.json())