Loading repository data…
Loading repository data…
ConnectSafelyAI / repository
Open-source LinkedIn API cookbook: Claude Skills, MCP servers, n8n & Make.com workflows, and Python/TypeScript snippets for AI agents, prospecting, and outreach automation.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Open-source recipes for the ConnectSafely.ai LinkedIn API: ready-to-run Claude Skills, Model Context Protocol (MCP) examples, n8n workflows, and code snippets for LinkedIn automation, outreach, lead research, and AI agents.
Get a ConnectSafely API key: connectsafely.ai/api-key
API access starts at $10/month (Ultimate Outreach plan). The free plan covers post-boosting only — see pricing for the full breakdown.
A growing library of runnable LinkedIn automation examples built on the ConnectSafely LinkedIn API. Every recipe runs end-to-end with only a single API key — no databases, no extra services. Designed for:
Code is plain Python or TypeScript with stdlib + requests/fetch. Skip the SDK churn.
Run the reference skill against any public LinkedIn profile in under a minute:
git clone https://github.com/ConnectSafelyAI/connectsafely-cookbook.git
cd connectsafely-cookbook
cp .env.example .env # then paste your CONNECTSAFELY_API_KEY
cd skills/prospect-researcher
# macOS / most Linux (stock Python ships pip3, not pip):
python3 -m pip install -r requirements.txt
python3 example.py https://www.linkedin.com/in/williamhgates/
# If your system has 'pip' and 'python' on PATH (Windows, Conda, venvs, some Linux):
pip install -r requirements.txt
python example.py https://www.linkedin.com/in/williamhgates/
The script auto-loads .env from the skill folder or any parent — a single .env at the repo root works for every skill. Real shell environment variables (export CONNECTSAFELY_API_KEY=…) always take priority over .env if both are set.
Both pip variants do the same thing.
python3 -m pipis the portable form that always works;pip/pythonare the shorthand that exist on systems where Python is configured for them. Pick whichever your terminal recognizes.
You'll get a Markdown outreach brief on stdout. See the full sample output.
Reusable Claude Skills — drop-in agent capabilities you can use from Claude Desktop, Claude Code, or the Anthropic API.
| Skill | What it does | Endpoints |
|---|---|---|
| prospect-researcher | Turn a LinkedIn profile URL into a structured outreach brief with conversation hooks and a draft DM | /linkedin/profile, /linkedin/posts/latest |
| _template | Starting point for new skill contributions | — |
More skills are on the way. Vote on what's next or request your own under issues labeled skill-request.
mkdir -p ~/.claude/skills
cp -R skills/prospect-researcher ~/.claude/skills/
# In Claude: "Research https://www.linkedin.com/in/<id>/ for me"
Claude reads the frontmatter in SKILL.md and routes to the skill automatically.
| Folder | What's there |
|---|---|
mcp/ | Model Context Protocol server configs and prompts for Claude Desktop, Cursor, Continue, and other MCP-aware clients |
n8n/ | 10 importable n8n workflows for LinkedIn automation (AI connection requests, commenter→HubSpot, post rewriter, more) |
make/ | 9 Make.com scenarios with public blueprint URLs (AI outreach, profile-visitors→HubSpot, keyword→DM, more) |
snippets/ | Single-purpose code samples in Python, TypeScript, and curl |
docs/ | Cookbook guides: auth, rate limits, errors, pricing |
The ConnectSafely API powers workflows like:
Each is one or two API calls. The skills/ folder turns them into copy-paste agent capabilities.
A managed LinkedIn API that wraps the most common automation actions — fetching profiles, sending messages, posting, commenting, searching — behind a single bearer-token endpoint. Your LinkedIn account stays connected through ConnectSafely's safety layer (rate-limit pacing, warmup, error recovery).
The product has a free plan, but it is scoped to post-boosting only and does not include API access. API access requires the Ultimate Outreach plan at $10/month. New accounts receive a trial. See docs/pricing.md.
Profiles, posts (read, comment, react, repost, search), messaging (DM and InMail), connection requests, follow/unfollow, people and company search, groups, jobs, account analytics, and Sales Navigator threads. Full reference at connectsafely.ai/docs.
Yes. The skills here ship as Claude Skills, but the underlying scripts are plain Python — wire them into LangChain tools, OpenAI function-calling, or any agent framework. The mcp/ folder shows the MCP integration path for Claude Desktop and Cursor.
Read docs/rate-limits.md. Every response includes X-RateLimit-* headers — pace off those rather than guessing. Hardest limits: 90 connection requests/week and 120 unique profile fetches/day per LinkedIn account.
Open a broken-skill issue. CI runs every skill weekly so we catch most drift early.
Built something useful? Open a PR. The quality bar:
Issue templates: request a skill · report a broken skill · share what you built
MIT — see LICENSE. Use freely in commercial projects.