publish to all your social media!

Fedica Skill

Fedica is a cross-platform social scheduler that publishes to X, LinkedIn, Threads, Mastodon, Bluesky (and more) from one compose box. This skill drives it through agent-browser.

Prerequisites

Safety

Fedica is public broadcast. Never publish or schedule without explicit user confirmation on:

Treat every Post Now / Add to Calendar / Update click like an email you cannot unsend.

Key gotchas

| Gotcha | Rule | |---|---| | Timezone | Fedica displays everything in GMT+00 (UTC) regardless of browser or user TZ. Convert to the user's local TZ before confirming a schedule. Example: 07:00 UTC = 09:00 Europe/Paris (CEST, summer) or 08:00 Europe/Paris (CET, winter). | | Bluesky limit | 300 graphemes max. Almost always the binding constraint — design around it first. | | Threads / Mastodon | 500 chars each. X and LinkedIn much more generous. | | Character counter | Bottom right of composer shows NNN / 300 (always anchored to Bluesky's 300). If the text exceeds a platform's limit, clicking Schedule pops an error listing which platforms fail. | | Custom Posts tab | Allows per-platform versions (long LinkedIn + short Bluesky). Use when trimming to 300 kills the message. | | Image upload | The visible camera icon only opens a hidden input that Fedica will not react to on direct upload. You must open the modal first: openTweetBoxAttachmentUploadModal(1). The modal's input is #imageUploader1 (note the trailing 1). | | Schedule button | It is a split button. The primary Schedule label alone does not open the modal. The dropdown entry #openScheduleButton (labelled "Specific date") is what opens the "When to publish?" modal. | | Date picker | Web component containing whose day buttons live in a shadow DOM. Reach them via document.querySelector('calendar-month').shadowRoot.querySelector('button[aria-label="April 20"]'). | | Chrome extension nag | A dialog "Fedica Browser extension" pops up on the Calendar page. Close with its X button, or use the "Don't remind me again" link, or Escape. | | Headless browser sandbox | In a headless/server environment the first agent-browser call needs --args "--no-sandbox" (or equivalent). |

Fast workflow (happy path)

# 1. Launch session (first call of the session may need --no-sandbox on servers)
agent-browser --args "--no-sandbox" open "https://fedica.com/dash/"
2. Log in if not already authenticated
   Dashboard shows a "Log in" button in the top-right if you are logged out.
   Use your own credential source; this skill does not fetch or store passwords.
   Fedica routes to account.fedica.com/oauth2/... (Azure-B2C-style form).
3. Open composer
agent-browser open "https://fedica.com/publish/"
4. Verify which networks are checked (snapshot shows them as checkboxes)
agent-browser snapshot 2>&1 | grep -i "checkbox.*-"
Uncheck any you do not want to target:
  agent-browser click @
5. Type the post
COMPOSE_REF=$(agent-browser snapshot 2>&1 | grep -oP 'textbox "Compose your post or thread" \[ref=\K[^\]]+')
agent-browser click @$COMPOSE_REF
agent-browser keyboard type "$(cat /tmp/post.txt)"
6. Attach image (skip if text-only)
agent-browser eval "openTweetBoxAttachmentUploadModal(1)"
sleep 1
agent-browser upload "#imageUploader1" "/absolute/path/to/image.png"
sleep 3  # let Fedica finish the upload
7. Open the When-to-publish modal
agent-browser eval "document.querySelector('#openScheduleButton').click()"
sleep 2
8. Pick the date (shadow DOM web component)
   Replace "April 20" with the target month + day (e.g. "May 3")
agent-browser eval "
  const sr = document.querySelector('calendar-month').shadowRoot;
  sr.querySelector('button[aria-label=\"April 20\"]').click();
"
9. Switch from Optimized → Exact Time, then set the time
   (find the Exact Time radio ref via snapshot, then click it)
EXACT_REF=$(agent-browser snapshot 2>&1 | grep -B1 '"Exact Time"' | grep -oP 'ref=\K[^\]]+' | head -1)
agent-browser click @$EXACT_REF
Time in UTC (Fedica shows/accepts GMT+00). Convert from local TZ first!
agent-browser eval "
  const t = document.querySelector('#scheduleTimeControl');
  const setter = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set;
  setter.call(t, '07:00');
  t.dispatchEvent(new Event('change', {bubbles:true}));
"
10. Confirm with the primary button in the modal
    New post  → "Add to Calendar"
    Edit mode → "Update"
CONFIRM_REF=$(agent-browser snapshot 2>&1 | grep -B1 -E 'Add to Calendar|Update' | grep -oP 'ref=\K[^\]]+' | head -1)
agent-browser click @$CONFIRM_REF

Verify a scheduled post

agent-browser open "https://fedica.com/schedule/"
Close the Chrome-extension nag dialog if it appears
agent-browser press Escape
Click a post from the calendar to get its preview modal
agent-browser find text "" click
Preview header shows: "YYYY Mon DD HH:MM AM/PM" in GMT+00
Post ID appears in the onclick handlers: editPost() and delPost(, ...)

Always re-verify the displayed time after scheduling. Subtract or add the UTC offset to get the user's local time, and restate that local time to them.

Editing / rescheduling

# From the preview popup, the pencil icon fires: editPost()
agent-browser eval "editPost()"
Opens composer with existing content and the scheduled date/time visible
Click the "Schedule" button next to the date to re-open the When-to-publish modal
Change date/time → click "Update" (not "Add to Calendar" in edit mode)

Composing for 5 platforms in one shot

Plan around the Bluesky 300-grapheme ceiling from the start. Techniques:

If the message needs the full long form, switch to the Custom Posts tab in the composer. Each platform then gets its own text field — full long version for LinkedIn/X, short teaser + link for Bluesky/Threads/Mastodon.

Character counting

Fedica counts graphemes, and its live NNN / 300 counter is authoritative. For an offline estimate, Python codepoint count is close but undercounts some emoji (e.g. 🏛️ = two codepoints):

s = open('/tmp/post.txt').read()
print('codepoints:', len(s))
For accurate grapheme count:
  pip install grapheme
  import grapheme; print(grapheme.length(s))

When you are close to the 300 limit, paste into the composer and read the live counter.

Troubleshooting

| Symptom | Fix | |---|---| | Login redirects to account.fedica.com/oauth2/... | Normal OAuth handoff; fill the password on the Azure-B2C-style form that appears. | | upload command fails with a CDP error | The file input element ID differs: #imageUploader (page-level, not wired up) vs #imageUploader1 (inside the modal). Open the modal first with openTweetBoxAttachmentUploadModal(1) and use the modal input. | | Date picker does not react to clicks | It is a shadow-DOM web component. Use document.querySelector('calendar-month').shadowRoot to reach the buttons. | | Post cannot be longer than N characters popup | The error lists the offending platforms. Either trim to the lowest limit, or switch to Custom Posts. | | Scheduled time is off by 1–2 hours | Fedica is in GMT+00. Adjust for the user's current offset (e.g. CEST = UTC+2, CET = UTC+1, EDT = UTC−4, EST = UTC−5). | | "Fedica Browser extension" dialog blocks the calendar page | Close with the X or the "Don't remind me again" link. |

Sensible defaults

When the user does not specify, propose and then confirm:

Do not assume — always restate the final plan (text preview, platforms list, local-time schedule) and wait for explicit go before clicking the confirm button.

Fedica endpoints

Post IDs are numeric integers. They appear in the editPost(...), delPost(...), and calendar-preview popup onclick handlers.

| Symptom | Fix | |---|---| | Login redirects to account.fedica.com/oauth2/... | Normal OAuth handoff; fill the password on the Azure-B2C-style form that appears. | | upload command fails with a CDP error | The file input element ID differs: #imageUploader (page-level, not wired up) vs #imageUploader1 (inside the modal). Open the modal first with openTweetBoxAttachmentUploadModal(1) and use the modal input. | | Date picker does not react to clicks | It is a shadow-DOM web component. Use document.querySelector('calendar-month').shadowRoot to reach the buttons. | | Post cannot be longer than N characters popup | The error lists the offending platforms. Either trim to the lowest limit, or switch to Custom Posts. | | Scheduled time is off by 1–2 hours | Fedica is in GMT+00. Adjust for the user's current offset (e.g. CEST = UTC+2, CET = UTC+1, EDT = UTC−4, EST = UTC−5). | | "Fedica Browser extension" dialog blocks the calendar page | Close with the X or the "Don't remind me again" link. |