Get bio, followers, tweets, and engagement

Twitter/X Profile Lookup

by gooseworks-ai · MIT license · ★ 1,220 on GitHub · updated Sep 21

Look up Twitter/X profiles - get bio, followers, tweets, and engagement

---
name: twitter-profile-lookup
description: Look up Twitter/X profiles - get bio, followers, tweets, and engagement
source: scrapecreators
---


# Twitter/X Profile Lookup

## Setup

Read `scrapecreators-api` first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.


Get profile information, tweets, and engagement data for any Twitter/X account.

## When to Use

Overview

Read scrapecreators-api first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.

Manual install (npx, ZIP)

Claude Codenpx skills add gooseworks-ai/goose-skills --skill twitter-profile-lookup -g -a claude-code

Claude Code (manual)

mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/gooseworks-ai/goose-skills/tar.gz/615c685f34f8 \
  | tar -xz -C ~/.claude/skills --strip-components=4 goose-skills-615c685f34f8/skills/social/capabilities/twitter-profile-lookup

Windows (PowerShell)

New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/96c1d1f27f977cc60a1c/twitter-profile-lookup.zip" -OutFile "$env:TEMP\twitter-profile-lookup.zip"; Expand-Archive "$env:TEMP\twitter-profile-lookup.zip" -DestinationPath "$HOME\.claude\skills" -Force

Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.

Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

SKILL.md2.4 KB
skill.meta.json340 B

Read the files here

gooseworks-ai/615c6852 files

SKILL.md

Show the full text102 lines

twitter-profile-lookup/SKILL.md102 lines · 2.4 KB

PreviewCode

Outline

RawView on GitHub

Twitter/X Profile Lookup

Setup

Read scrapecreators-api first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.

Get profile information, tweets, and engagement data for any Twitter/X account.

When to Use

User asks about a Twitter/X account
User wants to see someone's tweets
User asks "who is @username on Twitter?"
Research on a public figure or company
Social media due diligence

How It Works

Uses the ScrapeCreators API through its direct GooseWorks proxy.

Usage

Get User Profile

provider: scrapecreators
method: GET
path: /v1/twitter/profile
query:
  handle: openai

Get User's Tweets

provider: scrapecreators
method: GET
path: /v1/twitter/user-tweets
query:
  handle: openai

Parameters

Profile

handle (required) - Twitter handle (without @)

Tweets

handle (required) - Twitter handle (without @)
trim (optional) - Set to "true" for a trimmed response

Response

Profile Response

User display name and handle
Bio/description
Follower and following counts
Tweet count
Profile and banner image URLs
Verified status
Account creation date
Location and website (if set)

Tweets Response

Tweet text content
Like, retweet, reply counts
Media attachments (images, videos)
Timestamp
Engagement metrics

Examples

User: "What has OpenAI been posting on X?" Use the Get User's Tweets operation with handle: openai.

User: "Show me Sam Altman's recent tweets" Use the Get User's Tweets operation with handle: sama.

User: "What's Anthropic sharing on Twitter?" Use the Get User's Tweets operation with handle: AnthropicAI.

Error Handling

success: false — the API may temporarily be unable to access the profile; retry after a few seconds
Protected/private accounts return errors — no workaround
Rate limiting may cause failures on rapid sequential requests — add short delays between calls

Tips

Remove @ from handles
Protected/private accounts cannot be accessed
Returns recent tweets (not full history)
Rate limiting may apply for very frequent requests

1	---
2	name: twitter-profile-lookup
3	description: Look up Twitter/X profiles - get bio, followers, tweets, and engagement
4	source: scrapecreators
5	---
6
7
8	# Twitter/X Profile Lookup
9
10	## Setup
11
12	Read `scrapecreators-api` first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.
13
14
15	Get profile information, tweets, and engagement data for any Twitter/X account.
16
17	## When to Use
18
19	- User asks about a Twitter/X account
20	- User wants to see someone's tweets
21	- User asks "who is @username on Twitter?"
22	- Research on a public figure or company
23	- Social media due diligence
24
25	## How It Works
26
27	Uses the ScrapeCreators API through its direct GooseWorks proxy.
28
29	## Usage
30
31	### Get User Profile
32
33	```yaml
34	provider: scrapecreators
35	method: GET
36	path: /v1/twitter/profile
37	query:
38	handle: openai
39	```
40
41	### Get User's Tweets
42
43	```yaml
44	provider: scrapecreators
45	method: GET
46	path: /v1/twitter/user-tweets
47	query:
48	handle: openai
49	```
50
51	## Parameters
52
53	### Profile
54	- handle (required) - Twitter handle (without @)
55
56	### Tweets
57	- handle (required) - Twitter handle (without @)
58	- trim (optional) - Set to "true" for a trimmed response
59
60	## Response
61
62	### Profile Response
63	- User display name and handle
64	- Bio/description
65	- Follower and following counts
66	- Tweet count
67	- Profile and banner image URLs
68	- Verified status
69	- Account creation date
70	- Location and website (if set)
71
72	### Tweets Response
73	- Tweet text content
74	- Like, retweet, reply counts
75	- Media attachments (images, videos)
76	- Timestamp
77	- Engagement metrics
78
79	## Examples
80
81	User: "What has OpenAI been posting on X?"
82	Use the Get User's Tweets operation with `handle: openai`.
83
84	User: "Show me Sam Altman's recent tweets"
85	Use the Get User's Tweets operation with `handle: sama`.
86
87	User: "What's Anthropic sharing on Twitter?"
88	Use the Get User's Tweets operation with `handle: AnthropicAI`.
89
90	## Error Handling
91
92	- success: false — the API may temporarily be unable to access the profile; retry after a few seconds
93	- Protected/private accounts return errors — no workaround
94	- Rate limiting may cause failures on rapid sequential requests — add short delays between calls
95
96	## Tips
97
98	- Remove @ from handles
99	- Protected/private accounts cannot be accessed
100	- Returns recent tweets (not full history)
101	- Rate limiting may apply for very frequent requests
102