Spotlightr
Spotlightr is a video marketing platform that helps users create, host, and market interactive videos. It's used by marketers, educators, and businesses to increase engagement and conversions through video.
Official docs: https://help.spotlightr.com/en/
Spotlightr Overview
- Video
- Hotspot
- Action
- Integration
- Folder
- Project
- Tag
- User
- Comment
- Domain
- Player Skin
- Preset
- Branding Theme
- Subscription
- Invoice
- Coupon
- Bundle
- Payment Method
- Affiliate
- Webhook
- Notification
- API Key
- Workspace
- Report
- Export
- Import
- Live Stream
- Channel
- Engagement
- Lead
- Funnel
- A/B Test
- Overlay
- Call To Action
- Card
- End Screen
- Chapter
- Subtitle
- Audio Track
- Thumbnail
- Watermark
- Privacy Setting
- Playback Setting
- Sharing Setting
- Download Setting
- SEO Setting
- Analytics Setting
- Email Integration
- CRM Integration
- Marketing Automation Integration
- E-commerce Integration
- Social Media Integration
- Zapier Integration
- Google Analytics Integration
- Facebook Pixel Integration
- Custom Script
- Team
- Role
- Permission
- Activity Log
- Storage
- Bandwidth
- Encoding Profile
- Transcoding Task
- Content Delivery Network (CDN)
- Security Setting
- Single Sign-On (SSO)
- Two-Factor Authentication (2FA)
- Terms of Service
- Privacy Policy
- Cookie Policy
- GDPR Setting
- CCPA Setting
- Support Ticket
- Knowledge Base Article
- FAQ
- Tutorial
- Webinar
- Case Study
- Testimonial
- Integration Guide
- Developer Documentation
- API Endpoint
- SDK
- Plugin
- Theme
- Template
- Icon
- Font
- Color Palette
- Image
- File
- Text
- Code
- Embed Code
- Shortcode
- Variable
- Constant
- Setting
- Preference
- Configuration
- Option
- Parameter
- Argument
- Event
- Trigger
- Action
- Condition
- Loop
- Function
- Module
- Library
- Framework
- Platform
- System
- Application
- Website
- Page
- Post
- Comment
- Form
- Button
- Link
- Image
- Video
- Audio
- Document
- Spreadsheet
- Presentation
- Archive
- Backup
- Restore
- Sync
- Share
- Collaborate
- Publish
- Unpublish
- Schedule
- Automate
- Customize
- Personalize
- Localize
- Translate
- Scale
- Optimize
- Secure
- Monitor
- Analyze
- Report
- Debug
- Test
- Deploy
- Maintain
- Upgrade
- Downgrade
- Install
- Uninstall
- Configure
- Manage
- Create
- Read
- Update
- Delete
- Search
- Filter
- Sort
- Group
- Aggregate
- Calculate
- Validate
- Convert
- Transform
- Process
- Execute
- Run
- Stop
- Pause
- Resume
- Restart
- Import
- Export
- Upload
- Download
- Send
- Receive
- Connect
- Disconnect
- Authenticate
- Authorize
- Verify
- Encrypt
- Decrypt
- Sign
- Validate
- Approve
- Reject
- Request
- Respond
- Confirm
- Cancel
- Subscribe
- Unsubscribe
- Follow
- Unfollow
- Like
- Unlike
- Comment
- Share
- Rate
- Review
- Vote
- Flag
- Report
- Block
- Unblock
- Mute
- Unmute
- Hide
- Unhide
- Pin
- Unpin
- Save
- Unsave
- Add
- Remove
- Edit
- View
- Open
- Close
- Play
- Pause
- Stop
- Seek
- Volume
- Mute
- Fullscreen
- Caption
- Quality
- Speed
- Loop
- Repeat
- Shuffle
- Next
- Previous
- Record
- Capture
- Stream
- Broadcast
- Present
- Attend
- Join
- Leave
- Call
- Message
- Chat
- Notify
- Alert
- Remind
- Invite
- Accept
- Decline
- Assign
- Delegate
- Approve
- Reject
- Escalate
- Resolve
- Close
- Reopen
- Archive
- Restore
- Backup
- Sync
- Share
- Collaborate
- Publish
- Unpublish
- Schedule
- Automate
- Customize
- Personalize
- Localize
- Translate
- Scale
- Optimize
- Secure
- Monitor
- Analyze
- Report
- Debug
- Test
- Deploy
- Maintain
- Upgrade
- Downgrade
- Install
- Uninstall
- Configure
- Manage
- Create
- Read
- Update
- Delete
- Search
- Filter
- Sort
- Group
- Aggregate
- Calculate
- Validate
- Convert
- Transform
- Process
- Execute
- Run
- Stop
- Pause
- Resume
- Restart
Use action names and parameters as needed.
Working with Spotlightr
This skill uses the Membrane CLI to interact with Spotlightr. Membrane handles authentication and credentials refresh automatically — so you can focus on the integration logic rather than auth plumbing.
Install the CLI
Install the Membrane CLI so you can run membrane from the terminal:
npm install -g @membranehq/cli@latest
Authentication
membrane login --tenant --clientName=<agentType>
This will either open a browser for authentication or print an authorization URL to the console, depending on whether interactive mode is available.
Headless environments: The command will print an authorization URL. Ask the user to open it in a browser. When they see a code after completing login, finish with:
membrane login complete <code>
Add --json to any command for machine-readable JSON output.
Agent Types : claude, openclaw, codex, warp, windsurf, etc. Those will be used to adjust tooling to be used best with your harness
Connecting to Spotlightr
Use membrane connection ensure to find or create a connection by app URL or domain:
membrane connection ensure "https://spotlightr.com/" --json
The user completes authentication in the browser. The output contains the new connection id.
This is the fastest way to get a connection. The URL is normalized to a domain and matched against known apps. If no app is found, one is created and a connector is built automatically.
If the returned connection has state: "READY", skip to Step 2.
1b. Wait for the connection to be ready
If the connection is in BUILDING state, poll until it's ready:
npx @membranehq/cli connection get <id> --wait --json
The --wait flag long-polls (up to --timeout seconds, default 30) until the state changes. Keep polling until state is no longer BUILDING.
The resulting state tells you what to do next:
READY— connection is fully set up. Skip to Step 2.CLIENT_ACTION_REQUIRED— the user or agent needs to do something. TheclientActionobject describes the required action:clientAction.type— the kind of action needed:"connect"— user needs to authenticate (OAuth, API key, etc.). This covers initial authentication and re-authentication for disconnected connections."provide-input"— more information is needed (e.g. which app to connect to).clientAction.description— human-readable explanation of what's needed.clientAction.uiUrl(optional) — URL to a pre-built UI where the user can complete the action. Show this to the user when present.clientAction.agentInstructions(optional) — instructions for the AI agent on how to proceed programmatically.
After the user completes the action (e.g. authenticates in the browser), poll again with `membrane connection get <id> -