Agent skill

Linkedin Post Research

by gooseworks-ai in gooseworks-ai/goose-skills

Search LinkedIn posts by keywords, sorted by engagement or date.

MITAuto-check: notesWriting & Content

Install Linkedin Post Research

skills CLI
$ npx skills add gooseworks-ai/goose-skills --skill linkedin-post-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gooseworks-ai/goose-skills linkedin-post-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gooseworks-ai/goose-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/social/capabilities/linkedin-post-research .claude/skills/linkedin-post-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
linkedin-post-research
GitHub stars
1.2k
Used in
1 other repo
Token cost
~1.3k tokens
SKILL.md length
360 words
Files
3 (incl. scripts)
Skills in repo
273
Repo updated
First seen
Licence
MIT

At a glance

Search LinkedIn posts by keywords, sorted by engagement or date.

  • Works in 5 steps: Takes one or more keywords → Calls the… → Returns posts with author, text,… → …
  • Researching what people are saying about a topic on LinkedIn
  • SKILL.md covers When to Auto-Load, Prerequisites, How It Works and Quick Start, plus 6 more sections
  • Runs Python scripts from its folder; calls python3 and curl; reaches api.apify.com and linkedin.com; needs APIFY_API_TOKEN

What it does

Linkedin Post Research is an agent skill from gooseworks-ai/goose-skills. Search LinkedIn posts by keywords, sorted by engagement or date. Use when researching what people are saying about a topic on LinkedIn, finding high-engagement content, identifying thought leaders, or discovering warm leads through post engagement. Returns author, post text, reactions, comments, shares, post URL, and date. No LinkedIn cookies or login required.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `scripts/search_posts.py` and `skill.meta.json`).

It sits in Writing & Content, covering Social media posts and Web scraping. It works with LinkedIn and Apify. The repository describes itself as: Library of Growth & GTM skills + data APIs for Claude Code, Codex, Cursor to run ads, social, content, lead gen, seo and data scraping. The licence is MIT.

When your agent uses it

  • Researching what people are saying about a topic on LinkedIn
  • Finding high-engagement content
  • Identifying thought leaders
  • Discovering warm leads through post engagement

Example prompts

  • “/linkedin-post-research”

Requirements

  • Python 3
  • A credential in APIFY_API_TOKEN

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Takes one or more keywords
  2. Calls the apimaestro/linkedin-posts-search-scraper-no-cookies Apify actor
  3. Returns posts with author, text, engagement metrics, date, and URL
  4. Deduplicates across keywords by activity_id
  5. Sorts by engagement (total reactions) descending, or by date

What it can do on your machine

Read from SKILL.md and the folder at commit c650c6d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.apify.com
    • linkedin.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • APIFY_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Linkedin Post Research loads about 1.3k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 360 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:30
    ed for searching LinkedIn posts. Set in `.env`:
  • NoteMentions a .env fileSKILL.md:156
    _TOKEN` not set | Ask user to add it to `.env` |

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from gooseworks-ai/goose-skills at commit c650c6d, republished under its MIT licence (© gooseworks-ai). 360 words, ~1,316 tokens.

Download SKILL.mdSave it as .claude/skills/linkedin-post-research/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
linkedin-post-research
description
Search LinkedIn posts by keywords, sorted by engagement or date. Use when researching what people are saying about a topic on LinkedIn, finding high-engagement content, identifying thought leaders, or discovering warm leads through post engagement. Returns author, post text, reactions, comments, shares, post URL, and date. No LinkedIn cookies or login required.
tags
research, lead-generation

LinkedIn Post Research

Search LinkedIn for posts matching keywords via Apify. Returns posts sorted by engagement or date, with author info, full text, reaction counts, and direct URLs.

No LinkedIn cookies. No login. Just keywords in, posts out.

When to Auto-Load

Load this skill when:

  • User says "search LinkedIn posts", "what are people saying about X on LinkedIn", "find LinkedIn content about"
  • User wants to find high-engagement posts on a topic
  • User wants to identify who's posting about a specific topic (thought leader discovery)
  • User wants to find posts to extract commenters from (warm lead pipeline)

Prerequisites

Apify API Token

Required for searching LinkedIn posts. Set in .env:

APIFY_API_TOKEN=your_token_here

No LinkedIn cookies, login, or session tokens needed. That's the only setup.


How It Works

  1. Takes one or more keywords
  2. Calls the apimaestro/linkedin-posts-search-scraper-no-cookies Apify actor
  3. Returns posts with author, text, engagement metrics, date, and URL
  4. Deduplicates across keywords by activity_id
  5. Sorts by engagement (total reactions) descending, or by date

Quick Start

bash
# Single keyword search
python3 skills/capabilities/linkedin-post-research/scripts/search_posts.py \
  --keyword "AI sourcing" --max-items 20

# Multiple keywords
python3 skills/capabilities/linkedin-post-research/scripts/search_posts.py \
  --keyword "AI sourcing" --keyword "recruiting automation" --max-items 30

# Sort by date (most recent first)
python3 skills/capabilities/linkedin-post-research/scripts/search_posts.py \
  --keyword "AI agents" --sort-by date_posted --max-items 20

# Output as CSV
python3 skills/capabilities/linkedin-post-research/scripts/search_posts.py \
  --keyword "AI agents" --output csv --output-file results.csv

# Summary table
python3 skills/capabilities/linkedin-post-research/scripts/search_posts.py \
  --keyword "AI agents" --output summary

CLI Reference

FlagDefaultDescription
--keyword, -krequiredKeyword to search (can be repeated for multiple keywords)
--max-items50Max posts to return per keyword
--sort-byrelevanceSort order: relevance or date_posted
--output, -ojsonOutput format: json, csv, summary
--output-filestdoutWrite output to file
--tokenenv varApify API token (overrides APIFY_API_TOKEN env var)
--timeout120Max seconds to wait for Apify run
Show full SKILL.md (131 more words)Show less

Apify Actor Details

Actor: apimaestro/linkedin-posts-search-scraper-no-cookies

API call:

bash
curl -X POST "https://api.apify.com/v2/acts/apimaestro~linkedin-posts-search-scraper-no-cookies/runs?token=$APIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "AI agents",
    "maxItems": 50,
    "sortBy": "date_posted"
  }'

Polling for results:

bash
# Check run status
curl "https://api.apify.com/v2/acts/apimaestro~linkedin-posts-search-scraper-no-cookies/runs/{RUN_ID}?token=$APIFY_API_TOKEN"

# When status is SUCCEEDED, fetch results
curl "https://api.apify.com/v2/datasets/{DATASET_ID}/items?token=$APIFY_API_TOKEN"

Output Schema

json
{
  "author": "Jane Smith",
  "author_headline": "VP of Sales at Acme Corp",
  "author_profile_url": "https://www.linkedin.com/in/janesmith",
  "keyword": "AI sourcing",
  "reactions": 142,
  "comments": 28,
  "shares": 12,
  "reactions_by_type": {"LIKE": 100, "EMPATHY": 30, "PRAISE": 12},
  "date": "2026-04-01",
  "post_preview": "First 200 chars of the post text...",
  "full_text": "Complete post text...",
  "url": "https://www.linkedin.com/posts/...",
  "activity_id": "7447040447966826496",
  "hashtags": ["#AI", "#sales"],
  "is_repost": false,
  "content_type": "text"
}

Output Columns (CSV)

ColumnDescription
authorPost author name
author_headlineAuthor's LinkedIn headline
author_profile_urlAuthor's LinkedIn profile URL
keywordWhich search keyword matched
reactionsTotal reaction count
commentsComment count
sharesShare count
datePost date (YYYY-MM-DD)
post_previewFirst ~200 characters
urlDirect link to the LinkedIn post
activity_idUnique post identifier
hashtagsComma-separated hashtags

Cost

Apify charges per compute usage. ~50 posts costs approximately $0.01-0.05 depending on the actor's pricing tier. The script prints cost info after each run.

Error Handling

ErrorFix
APIFY_API_TOKEN not setAsk user to add it to .env
Apify run fails or times outRetry once. If still fails, try a broader keyword.
0 resultsKeyword may be too specific. Try broader terms.

© gooseworks-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in skills/social/capabilities/linkedin-post-research of gooseworks-ai/goose-skills.

  • SKILL.md
  • scripts/search_posts.py
  • skill.meta.json

Open the folder on GitHubat commit c650c6d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in gooseworks-ai/goose-skills, which our catalogue first saw on October 9, 2026.

Compare with similar skills

Linkedin Post Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Linkedin Post Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Linkedin Post Research this skillgooseworks-ai/goose-skills1.2k1 repos~1.3kAutomated safety check: NotesMIT
Linkedin Engager Analyticssergebulaev/linkedin-skills4.4k1 repos~1.4kAutomated safety check: PassMIT
Post Scorercharlie947/social-media-skills3.8k—~2.4kAutomated safety check: PassMIT
Fullenrich Content EngagersOthmane-Khadri/YALC-the-GTM-operating-system318—~1.5kAutomated safety check: WarnMIT
Linkedin Comment To Outreachgethouston/houston118—~2.1kAutomated safety check: PassMIT
Social Fetchcoreyhaines31/makerskills851—~1.9kAutomated safety check: PassMIT

Similar skills

  • Linkedin Engager Analytics

    sergebulaev/linkedin-skills

    Pull the people who liked or commented on any LinkedIn post and segment them by ICP fit (peer / aspirational / prospect / other).

    4.4k GitHub starsUsed in 1 repo~1.4k tokens
    Writing & ContentAuto-check passed
  • Post Scorer

    charlie947/social-media-skills

    Score a LinkedIn post using real performance data. An agent skill from charlie947/social-media-skills.

    3.8k GitHub stars~2.4k tokensUpdated 26 days ago
    Writing & ContentAuto-check passed
  • Fullenrich Content Engagers

    Othmane-Khadri/YALC-the-GTM-operating-system

    A skill your agent uses when the user says "enrich people who engaged with this post", "qualify post engagers with FullEnrich", "scrape and enrich LinkedIn post {URL}", "engagers from this post into…

    318 GitHub stars~1.5k tokensUpdated 1 mo ago
    Writing & ContentAuto-check: warnings
  • Turn a single LinkedIn post URL into a paused cold email campaign in Instantly.

    118 GitHub stars~2.1k tokensUpdated today
    Writing & ContentAuto-check passed
  • Social Fetch

    coreyhaines31/makerskills

    When you or another skill needs to fetch the content of a social media post by URL — tweet, X thread, LinkedIn post, Instagram post, TikTok video, Bluesky post, Reddit thread, Mastodon status…

    851 GitHub stars~1.9k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Linkedin Skills

    alirezarezvani/claude-skills

    A skill your agent uses when someone wants to grow an organic LinkedIn presence — a content strategy for a career change or consulting or thought leadership, a rewritten profile or headline, post…

    28k GitHub stars~1.4k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed

More from gooseworks-ai/goose-skills

All 273 skills in this repo
  • Reddit Post Finder

    gooseworks-ai/goose-skills

    Scrape and search Reddit posts using Apify. An agent skill from gooseworks-ai/goose-skills.

    1.2k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Create Image Fal

    gooseworks-ai/goose-skills

    Generate or edit an image via any FAL image model (nano-banana edit, gpt-image, flux, ...), ROUTED THROUGH THE fal-proxy so it bills the Ads agent.

    1.2k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Render Hook Replacement

    gooseworks-ai/goose-skills

    Replace an existing video's opening with a supplied clip or free kinetic text hook while retaining and verifying every original body frame, audio, captions and ending.

    1.2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Blog Feed Monitor

    gooseworks-ai/goose-skills

    Scrape blog posts via RSS feeds (free, no API key) with Apify fallback for JS-heavy sites.

    1.2k GitHub starsUsed in 1 repo~578 tokens
    Auto-check passed
  • Competitor Post Engagers

    gooseworks-ai/goose-skills

    Find leads by scraping engagers from a competitor's top LinkedIn posts.

    1.2k GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check: notes
  • Render Chatgpt Chat

    gooseworks-ai/goose-skills

    Assemble a ChatGPT chat-reveal video ad from a thread + timeline JSON — one continuous Playwright recording of a ChatGPT mobile chat (user types with the iOS keyboard up → taps send → keyboard…

    1.2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Works with

Questions about Linkedin Post Research

What does Linkedin Post Research do?

Search LinkedIn posts by keywords, sorted by engagement or date. Linkedin Post Research is an agent skill from gooseworks-ai/goose-skills. Search LinkedIn posts by keywords, sorted by engagement or date.

When should I use Linkedin Post Research?

Linkedin Post Research fits situations like: researching what people are saying about a topic on LinkedIn; finding high-engagement content; identifying thought leaders; discovering warm leads through post engagement.

How do I install Linkedin Post Research in Claude Code?

Run `npx skills add gooseworks-ai/goose-skills --skill linkedin-post-research -a claude-code`. Or copy the skill folder (skills/social/capabilities/linkedin-post-research in gooseworks-ai/goose-skills) into .claude/skills/linkedin-post-research in your project. Claude Code loads it when a task matches its description.

How do I install Linkedin Post Research in Codex?

Run `npx skills add gooseworks-ai/goose-skills --skill linkedin-post-research -a codex`. Or copy the skill folder (skills/social/capabilities/linkedin-post-research in gooseworks-ai/goose-skills) into .agents/skills/linkedin-post-research in your project. Codex loads it when a task matches its description.

Can I use Linkedin Post Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gooseworks-ai/goose-skills --skill linkedin-post-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/linkedin-post-research, .gemini/skills/linkedin-post-research, .github/skills/linkedin-post-research and .opencode/skills/linkedin-post-research in your project.

What does Linkedin Post Research need to run?

Going by SKILL.md and its folder, Linkedin Post Research needs Python for the scripts in its folder, the command-line tools its instructions call (python3 and curl) and credentials named APIFY_API_TOKEN. Our summary lists: Python 3; A credential in APIFY_API_TOKEN.

Does Linkedin Post Research access the network?

SKILL.md names 2 domains. In commands or code: api.apify.com and linkedin.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Linkedin Post Research safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Linkedin Post Research use?

Linkedin Post Research is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Linkedin Post Research use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Linkedin Post Research?

Skills that share tags, products or a category with Linkedin Post Research: Linkedin Engager Analytics (sergebulaev/linkedin-skills, 4.4k stars), Post Scorer (charlie947/social-media-skills, 3.8k stars), Fullenrich Content Engagers (Othmane-Khadri/YALC-the-GTM-operating-system, 318 stars) and Linkedin Comment To Outreach (gethouston/houston, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Linkedin Post Research?

gooseworks-ai (a GitHub organization) maintains it in gooseworks-ai/goose-skills, which has 1,240 GitHub stars. The repository holds 273 skills in this directory. The repository was last updated on October 8, 2026.

Source: gooseworks-ai/goose-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.