Social feed on a website with Juicer

Goal: in one conversation the user goes from "put our socials on the site" to a working embed code, with only the posts they want.

Steps

1. Connect Juicer (see the juicer skill). A free Juicer account is enough to start; get_account shows the feed and source limits.
2. Ask what to show, in one message: which accounts and hashtags per network, where on the site, and what to keep out (competitors, swear words, certain hashtags).
3. Check the accounts with get_data_profiles when the user gives names rather than exact handles, and confirm with the user before adding anything. Showing the wrong brand on someone's website is the worst outcome here.
4. Create the feed: create_feed with a clear name ("Homepage social feed").
5. Add sources: call list_platforms for the exact platform and term_type values, then create_source once per account or hashtag.
   • Some sources need the user to connect their own account (Instagram stories and mentions, Facebook mentions, Slack, Tumblr). If create_source returns social_account_required, call create_social_account_connect_url, send the link to the user and explain it opens a sign-in with that network and expires in 30 minutes. Retry after they say it is done.
   • If the feed or source limit is reached, show the user the upgrade link from the error. Do not delete their other feeds to make room.
   • Instagram accounts: only the user's own. An Instagram username source keeps updating only when that same account is connected through Instagram login. Before adding it, call create_social_account_connect_url with provider instagram_login, send the link (it expires in 30 minutes), confirm with get_social_account_status, then add the source. Someone else's account (a partner, a celebrity, a competitor) gets one first pull and then stops: tell the user that instead of adding it silently.
   • Instagram hashtags need an Instagram Business account connected through Facebook (provider facebook). Meta allows 30 different hashtags per week per business account.
   • Plan limits on the free plan: after the trial, X, TikTok hashtag and keyword, Reddit and LinkedIn sources stop syncing, Bluesky needs Pro or Enterprise and feeds refresh once a day. If list_sources shows a source as not syncable for one of these reasons, say so and show the upgrade link instead of handing over the feed as working.
   • Credits: each source costs credits for its first fetch (1 to 6 by network, same rates as data lookups). Check the balance first and tell the user what adding the sources will cost.
   • Check every source after adding it: list_sources shows each source's sync status. If one is not syncable, tell the user the reason in plain words and the fix. Never hand over an embed code as finished while its only source will not update.
6. Set moderation with update_feed:
   • profanity: true and prevent_duplicates: true are good defaults.
   • disallowed: comma-separated words to block (competitor names, words the user listed).
   • queue: true if the user wants to approve every post before it shows.
7. Review the first posts: list_feed_posts, then show the user 5 to 10 with links. Reject anything off-brand with moderate_post (reject), pin the best one (pin) if they want a post on top.
8. Hand over the embed code: get_feed_embed returns JavaScript, iframe and WordPress versions. Give the one that fits their site:
   • WordPress: the shortcode, pasted into a Shortcode block. It needs the Juicer WordPress plugin installed; say so.
   • Wix, Squarespace, Webflow, Shopify: the JavaScript snippet in an HTML or Custom Code block.
   • Plain HTML: the JavaScript snippet where the feed should appear.
9. Finish with the feed name, what it shows, how it is moderated and the link to change the look in the Juicer dashboard (https://www.juicer.io/dashboard).

Good to know

• New posts appear on their own; the feed syncs automatically. How often depends on the plan.
• Layout, colours and post count are set in the Juicer dashboard; the embed code does not change when the design does.
• Ask before deleting any feed, source or post.