API Long-Form Bluesky 2026: Alat Pihak Ketiga

9 Juli 2026 · 10 menit baca · Panduan

Format post panjang Bluesky diluncurkan untuk semua pengguna pada akhir Mei 2026, dan gelombang pertama tooling di sekitarnya hampir seluruhnya sisi-baca: klien yang dapat merender embed baru, mirror yang dapat menarik post ke Markdown, dan permukaan pencarian yang dapat mengindeks body. Pada awal Juli 2026, situasinya bergeser. Bluesky telah secara publik berkomitmen untuk membuka sisi-tulis dari API long-form ke alat ingestion pihak ketiga, dengan rilis SDK stabil pertama ditargetkan untuk Agustus 2026. Panduan ini adalah seperti apa playbook sisi-tulis terlihat sementara itu, untuk kreator atau developer alat yang ingin mengirim jalur publikasi long-form Bluesky sebelum SDK resmi menjadi GA.

Playbook sisi-baca yang kami publikasikan pada 6 Juli mencakup menarik post panjang ke satu inbox dan mengonversinya ke Markdown. Artikel ini adalah pelengkap: mendorong post panjang dari alat pihak ketiga ke Bluesky melalui API tulis publik baru, dengan disiplin Markdown-first yang sama di sisi input. Kedua bagian bersama-sama adalah stack konten Bluesky portabel dan script-driven yang dapat dijalankan oleh kreator mana pun di infrastruktur mereka sendiri.

Apa Sebenarnya API Tulis Long-Form Itu

Bluesky tidak memperkenalkan endpoint baru untuk post panjang. Format long-form hidup di atas record app.bsky.feed.post yang sudah ada, di field embeds baru yang menunjuk ke struktur app.bsky.embed.recordWithMedia. Body di dalam embed adalah dokumen Markdown; klien publik merendernya sebagai kartu scroll panjang. Tipe record yang sama, endpoint XRPC yang sama, alur auth yang sama. Alat pihak ketiga yang sudah tahu cara menulis post 280 karakter melalui com.atproto.repo.createRecord dapat menulis post panjang dengan mengisi field embed dengan struktur long-form, tanpa SDK baru.

Untuk sisi-baca, itulah seluruh ceritanya. Untuk sisi-tulis, ada tiga hal yang perlu diketahui tentang apa yang dikirim sebelum SDK Agustus 2026:

• Developer preview di belakang flag. Jalur tulis untuk struktur embed long-form aktif di endpoint publik, tetapi digated di belakang developer flag di SDK resmi. Alat pihak ketiga yang mengenai endpoint secara langsung melalui panggilan XRPC sudah dapat menulis post panjang. Alat yang menggunakan SDK resmi perlu men-set flag di config klien sampai rilis stabil.
• OAuth adalah auth yang direkomendasikan untuk alat multi-pengguna. App password masih berfungsi dan masih merupakan jalur teringan untuk alat pribadi, tetapi apapun yang menulis atas nama lebih dari satu pengguna harus menggunakan OAuth dengan scope per-aplikasi. Tim Bluesky telah mengkonfirmasi bahwa scope OAuth untuk tulis long-form sama dengan tulis short-form; tidak ada scope baru yang diperkenalkan.
• SDK stabil pertama ditargetkan untuk Agustus 2026. SDK itu akan mengunci bentuk JSON dari embed long-form, mendokumentasikan rate limit, dan menambahkan panduan migrasi untuk alat yang menggunakan developer preview. Sampai saat itu, perlakukan bentuk JSON sebagai stabil tetapi harapkan penambahan field kecil di rilis SDK.

Untuk developer alat yang mengirim pada Juli 2026, jalur praktis adalah: gunakan endpoint publik dengan app password untuk akun Anda sendiri, prototipe panggilan tulis, dan bersiaplah untuk beralih ke OAuth + SDK stabil segera setelah keluar pada Agustus. Biaya menulis integrasi dua kali kecil dibandingkan biaya menunggu SDK dan kehilangan dua bulan pertama trafik cross-post.

Workflow Tulis Enam Langkah

Workflow tulis lengkap, dari ujung ke ujung, memiliki enam langkah. Empat di antaranya script-driven dan dua interface-driven. Langkah interface-driven (langkah 1, pembuatan app password; langkah 5, submisi mirror) adalah satu-satunya tempat manusia harus berada di loop, dan keduanya adalah setup one-time. Setelah selesai, seluruh pipeline berjalan dari satu make publish pada file Markdown.

Langkah 1: Buat app password

App password adalah token berscope per-aplikasi yang dapat dicabut pengguna dari UI pengaturan Bluesky tanpa mempengaruhi sesi utama mereka. Buat satu di Settings -> App Passwords -> Add App Password, berikan nama (mis. "third-party-longform-publisher"), dan salin token yang ditampilkan satu kali. Simpan di secrets manager, bukan di repo. Token memiliki scope tulis yang sama dengan sesi utama Anda tetapi di-scope ke nama aplikasi di log audit, yang berguna ketika Anda men-debug tulis yang buruk yang tidak Anda lakukan dengan sengaja.

# 1. Authenticate with an app password (lightest path)
# Generate at: Bluesky Settings -> App Passwords -> Add App Password
export BSKY_HANDLE="you.bsky.social"
export BSKY_APP_PASSWORD="xxxx-xxxx-xxxx-xxxx"

# 2. Create a session via com.atproto.server.createSession
curl -X POST "https://bsky.social/xrpc/com.atproto.server.createSession" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "'"$BSKY_HANDLE"'",
    "password":  "'"$BSKY_APP_PASSWORD"'"
  }'

# Response: {"accessJwt": "...", "did": "did:plc:...", ...}

Langkah 2: Tulis body post dalam Markdown

Body long-form Bluesky adalah Markdown. Bukan subset, bukan flavor, bukan turunan. CommonMark standar dengan ekstensi GFM untuk tabel dan task list. Body hidup di field embed.media.external.description, dengan 200 karakter pertama digunakan sebagai preview link di timeline publik. Body lengkap di-fetch ketika pembaca mengklik untuk membuka.

Implikasi untuk developer alat adalah bahwa seluruh jalur tulis long-form dapat Markdown-first. File Markdown yang sama yang Anda tulis untuk post blog, newsletter Substack, atau artikel LinkedIn dapat menjadi source of truth untuk post panjang Bluesky, dengan judul di embed.media.external.title dan body di embed.media.external.description (dibatasi 200 karakter untuk preview, dengan body lengkap dirujuk melalui field canonical URL). Ini adalah bentuk yang sama yang digunakan playbook sisi-baca untuk mirror, dan simetri itulah yang membuat kedua sisi composable.

Langkah 3: Tulis record

Setelah Anda memiliki session token dan body Markdown, panggilan tulis adalah satu POST tunggal ke com.atproto.repo.createRecord. collection adalah app.bsky.feed.post, repo adalah DID pengguna, dan record.embed adalah struktur long-form. Respons membawa post URI, yang Anda perlukan untuk langkah mirror dan untuk field canonical URL di permukaan kutipan.

# 3. Write a long-form post via the new public write API
# app.bsky.feed.post with embeds field carrying Markdown body
curl -X POST "https://bsky.social/xrpc/com.atproto.repo.createRecord" \
  -H "Authorization: Bearer $BSKY_ACCESS_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "repo": "did:plc:YOUR_DID_HERE",
    "collection": "app.bsky.feed.post",
    "record": {
      "$type": "app.bsky.feed.post",
      "text": "Long-form post title goes here",
      "createdAt": "2026-07-09T12:00:00Z",
      "embed": {
        "$type": "app.bsky.embed.recordWithMedia",
        "media": {
          "$type": "app.bsky.embed.external",
          "external": {
            "uri": "https://yourdomain.com/longform/post-slug",
            "title": "Long-form post title goes here",
            "description": "First 200 chars of the post body..."
          }
        }
      }
    }
  }'

# 4. Capture the post URI from the response
# -> at://did:plc:.../app.bsky.feed.post/3k...xyz

Langkah 4: Konversi Markdown ke struktur embed

Untuk alat yang mempublikasikan banyak post, konversi dari Markdown ke JSON embed Bluesky adalah bagian yang diimplementasi-ulang. Di bawah ini adalah versi yang berfungsi, dalam 20 baris Python, yang dapat dijatuhkan oleh alat pihak ketiga mana pun. Itu menggunakan python-frontmatter untuk membaca front matter (title, canonical_url, description) dan pass regex untuk strip Markdown untuk preview description.

# 5. Convert a Markdown long-form body to the embed structure
# This is the part every third-party tool will need to ship before August 2026
import re, json, frontmatter

def md_to_bluesky_embed(md_path, max_desc_len=200):
    """Convert a Markdown file to the Bluesky long-form embed JSON shape."""
    post = frontmatter.load(md_path)
    body = post.content
    # Strip Markdown for description preview
    plain = re.sub(r'[#*_`>\[\]()]', '', body)
    plain = re.sub(r'\s+', ' ', plain).strip()
    description = plain[:max_desc_len]
    return {
        "$type": "app.bsky.embed.recordWithMedia",
        "media": {
            "$type": "app.bsky.embed.external",
            "external": {
                "uri": post.metadata.get("canonical_url", ""),
                "title": post.metadata.get("title", "Untitled"),
                "description": description
            }
        }
    }

embed = md_to_bluesky_embed("post.md")
print(json.dumps(embed, indent=2))

Langkah 5: Mirror ke permukaan citation-ready

Post panjang Bluesky, secara default, hanya dapat diindeks di dalam pencarian Bluesky sendiri dan firehose AT Protocol. Agen AI (GPTBot, ClaudeBot, PerplexityBot) tidak meng-crawl app Bluesky, jadi post panjang tanpa mirror eksternal tidak terlihat oleh lapisan pencarian AI. Perbaikannya adalah mirror post ke URL stabil dan citation-ready pada hari yang sama Anda mempublikasikan ke Bluesky. Mirror harus membawa body Markdown lengkap, menaut balik ke post Bluesky, dan dikirimkan ke permukaan crawl standar (sitemap, llms.txt, Bing webmaster, IndexNow).

ThreadGrab adalah salah satu mirror tersebut, dan jalur publikasi adalah sama dengan yang Anda gunakan untuk permukaan long-form lainnya: POST source URI, public URL, judul, dan body Markdown ke endpoint ingest. Halaman mirror akan live dalam satu menit, entri sitemap ditambahkan secara otomatis, dan post dapat dijangkau oleh GPTBot dan ClaudeBot dalam siklus crawl berikutnya.

# 6. Mirror the published long-form on threadgrab.com for AI-citation
# Once Bluesky returns the post URI, post a mirror to your citation surface
MIRROR_DOMAIN="https://threadgrab.com"
BSKY_POST_URI="at://did:plc:abc.../app.bsky.feed.post/3kxyz..."

# Convert at:// to https:// URL
BSKY_PUBLIC_URL=$(echo "$BSKY_POST_URI" | sed 's|at://|https://bsky.app/profile/|; s|/app.bsky.feed.post/|/post/|')

# Write the mirror page (same Markdown, with Bluesky embed linking back)
cat > mirror.html <