How to publish a feed#

Supercell is a feed generator, that is to say it is the service that fulfills feed requests and returns the posts that are displayed.

To invoke Supercell, you first need to create a record on your PDS saying that you are publishing a feed for others to use. This is called feed publishing.

This is done by creating a record on your PDS with the following structure:

{
  "$type": "app.bsky.feed.generator",
  "did": "did:web:the_hostname",
  "displayName": "Feed A",
  "description": "A useful feed.",
  "createdAt": "2024-10-30T16:15:31Z"
}

The did is a did:web identifier where the hostname is used to service a DID document that contains a "BskyFeedGenerator" service structure with the hostname to make API calls.

Publish script#

The publish.py script can be used to create new feed records or update existing ones.

1. Create a new virtual environment to run the script in: python -m venv ./venv/
2. Install the atproto library in the virtual environment: ./venv/bin/pip install atproto
3. Invoke the script using the virtual environment: ./venv/bin/python ./etc/publish.py --help