gooseworks-ai/goose-skills / skills/marketing/marketing-data-access
marketing-data-access
VerifiedHow to get live public data (ads libraries, social posts and comments, search results, creator profiles), business identity/work-contact reads, domain SEO metrics and paid media generation through GooseWorks, with no vendor key. Load before any playbook step that reads public data or calls an outside model: which proxy call fits the job, what it costs, how to get the human's yes, and what to do when the data is not reachable. Not for brand facts (read the brand brain) or the customer's own ad accounts (the GooseWorks ads tools, or an ads connector they have).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.8 KB |
| focused-reads.md | markdown | 3.4 KB |
| skill.meta.json | config | 626 B |
focused-reads.md
View on GitHub# Focused social data reads
Return the rows or ranking the marketer requested. A data list does not require a strategy, calendar or full report. Do the shared connection/brand setup when the request is brand-specific, then load only the relevant source section of `../spend-gate/proxy-endpoints.md` (the spend-gate skill). Paid calls keep its quote/ceiling gate; stop before another page would exceed the approved ceiling.
## Read and deliver
1. Resolve the account, exact topic/hashtag, requested count and time window from the ask. If the timezone matters and is unknown, state the timezone used. The response's actual published timestamp decides inclusion.
2. Use the named endpoint's documented pagination token. Deduplicate on platform post id or canonical URL, not text. Keep returned engagement values, including zero; absent values stay unknown.
3. Continue until the requested count/window is covered, results end, a token repeats, or the approved ceiling is reached. An error or early stop yields a partial list with its reason, not a claim that no more posts exist.
4. Deliver a compact table or requested CSV: link, author, published date, text/caption and the requested measures. Include the source, fetched-at date, filter/ranking and coverage in a short note. CSV cells preserve quotes/newlines and escape spreadsheet formulas from untrusted text. Save personal rows only in the permitted workspace/download, not the brand brain.
## Match the exact request
| Request | Method and completion |
|---|---|
| Last 30 Instagram posts with likes | Account posts, newest-first where supported; follow the returned `next_max_id`. Return thirty unique posts or the actual smaller count with the stopping reason. Preserve unavailable likes as unknown. |
| Top TikToks for a hashtag this week | Exact hashtag endpoint first. Verify hashtag membership and timestamps; drop out-of-window posts, then sort the retrieved in-window sample by the requested measure. A keyword search may find candidates, but is not proof of exact hashtag membership or exhaustive coverage. Say "highest-liked in the sample" unless coverage actually establishes more. |
| Most-liked LinkedIn topic posts this month | Topic post search, the documented window and cursor. Filter exact dates; paginate relevance-ranked pages without assuming the first old item ends the window. Sort by likes if the response exposes likes. Otherwise name total reactions accurately and state that LIKE-only ranking could not be established. Never label a rolling last-month window as a complete calendar month. |
| Top LinkedIn voices in a topic/country | Group actual topic posts by author; verify the requested geography from a profile/source, and rank by the specified audience or recent topic-engagement measure. State sample size and unknowns. Neither cross-platform followers nor a few discovered authors establish an exhaustive LinkedIn top-50 directory. |
| People complaining about a problem | Themes and quoted evidence use research-market; a requested list of fitting named authors uses research-audience's existing pain-language/list method. Do not add everyone who reacted as though they expressed that pain. |
For a focused run, do not widen into account audits or posting recommendations unless the marketer requests them. If the source lacks the necessary period, measure or identity, show the exact shortfall rather than silently changing the question.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |