Skip to content

Commit ccf6497

Browse files
jhjhjh94benface
andauthored
Remove spam scoring related FAQs + Fixed formatting with prettier (#1074)
* Remove spam scoring related FAQs * Fixed formatting with prettier * added FAQ (Quick Setup) for skills.md * fixed url to prod + prettier format * Update website/src/pages/en/ai-suite/token-api-skills/quick-setup.mdx sidebarTitle: Quick Setup removed Co-authored-by: Benoît Rouleau <benoit.rouleau@icloud.com> --------- Co-authored-by: Benoît Rouleau <benoit.rouleau@icloud.com>
1 parent f957884 commit ccf6497

7 files changed

Lines changed: 44 additions & 64 deletions

File tree

website/src/openApi/tokenApi.json

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6436,7 +6436,7 @@
64366436
"get": {
64376437
"operationId": "getV1EvmNftCollections",
64386438
"summary": "NFT Collection",
6439-
"description": "Returns NFT collection metadata, supply stats, owner count, and transfer history.\n\nThe `spam_status` flag indicates if the NFT is likely spam. If status shows `pending`, retry in a few seconds.\n\nSpam detection is supported for:\n\n* mainnet\n* base\n* polygon\n* arbitrum-one\n* avalanche\n* optimism\n* bsc",
6439+
"description": "Returns NFT collection metadata, supply stats, owner count, and transfer history.",
64406440
"tags": [
64416441
"EVM NFTs"
64426442
],
@@ -6518,16 +6518,6 @@
65186518
"polygon",
65196519
"unichain"
65206520
]
6521-
},
6522-
"spam_status": {
6523-
"type": "string",
6524-
"enum": [
6525-
"spam",
6526-
"not_spam",
6527-
"pending",
6528-
"not_supported",
6529-
"error"
6530-
]
65316521
}
65326522
},
65336523
"required": [
@@ -6540,8 +6530,7 @@
65406530
"total_supply",
65416531
"total_unique_supply",
65426532
"total_transfers",
6543-
"network",
6544-
"spam_status"
6533+
"network"
65456534
]
65466535
}
65476536
},
@@ -6613,8 +6602,7 @@
66136602
"total_supply": 8888,
66146603
"total_unique_supply": 8888,
66156604
"total_transfers": 193641,
6616-
"network": "mainnet",
6617-
"spam_status": "pending"
6605+
"network": "mainnet"
66186606
}
66196607
]
66206608
}
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
{
22
"ai-introduction": "The Graph's AI",
33
"subgraph-mcp": "Subgraph MCP",
4-
"token-api-mcp": "Token API MCP"
4+
"token-api-mcp": "Token API MCP",
5+
"token-api-skills": "Token API Skills"
56
}

website/src/pages/en/ai-suite/_meta.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,5 @@ export default {
44
'ai-introduction': titles['ai-introduction'],
55
'subgraph-mcp': titles['subgraph-mcp'],
66
'token-api-mcp': titles['token-api-mcp'],
7+
'token-api-skills': titles['token-api-skills'],
78
}
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
export default {
2+
'quick-setup': '',
3+
}
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
title: Quick Setup
3+
---
4+
5+
## Quick Setup
6+
7+
1. Create the skill directory and download the file:
8+
9+
```bash
10+
mkdir -p ~/.claude/skills/token-api
11+
curl -o ~/.claude/skills/token-api/SKILL.md https://token-api.thegraph.com/skills.md
12+
```
13+
14+
2. Verify it works by typing `/token-api` in Claude Code.
15+
16+
That's it.
17+
18+
## Where Skills Live
19+
20+
| Location | Path | Scope |
21+
| -------- | ---------------------------------- | -------------------- |
22+
| Personal | `~/.claude/skills/<name>/SKILL.md` | All your projects |
23+
| Project | `.claude/skills/<name>/SKILL.md` | Current project only |
24+
25+
For project-scoped usage (committed to Git so teammates get it too), use `.claude/skills/` in your repository.
26+
27+
## How It Works
28+
29+
- Claude Code auto-discovers `SKILL.md` files in `.claude/skills/` directories.
30+
- Skills are invoked with `/skill-name` (e.g., `/token-api`).
31+
- Skills can also be triggered automatically by Claude when relevant to your request.
32+
33+
## Keeping It Updated
34+
35+
If the remote file changes, re-run the `curl` command to fetch the latest version. You could also script this if needed.

website/src/pages/en/token-api/evm-nfts/collections.mdx

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,3 @@ template:
77
---
88

99
Returns NFT collection metadata, supply stats, owner count, and transfer history.
10-
11-
The `spam_status` flag indicates if the NFT is likely spam. If status shows `pending`, retry in a few seconds.
12-
13-
Spam detection is supported for:
14-
15-
- Arbitrum One
16-
- Avalanche C-Chain
17-
- Base Mainnet
18-
- BSC Mainnet
19-
- Ethereum Mainnet
20-
- Optimism Mainnet
21-
- Polygon Mainnet

website/src/pages/en/token-api/faq.mdx

Lines changed: 0 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -305,42 +305,6 @@ No, these are optional. MCP is an advanced feature allowing AI assistants to int
305305

306306
Yes, you need to provide your Token API token to the MCP for authenticating with the Token API. The MCP makes API requests on your behalf when your LLM interacts with it.
307307

308-
## NFT Spam Detection
309-
310-
### What is NFT spam detection?
311-
312-
NFT collections on supported chains contain a spam status field indicating whether the collection is likely spam or not spam.
313-
314-
### How do I retrieve the spam status for a collection?
315-
316-
See the spam_status field on the [`/v1/evm/nft/collections/`](/token-api/evm-nfts/collections/) endpoint.
317-
318-
### Why am I seeing "pending" spam status?
319-
320-
There are millions of collections and we only analyze for spam on demand. If you see a pending status, query it again after 5-10 seconds and the status should be updated.
321-
322-
### What chains contain NFT spam detection?
323-
324-
NFT spam detection is currently supported for the following chains:
325-
326-
- Arbitrum One
327-
- Avalanche C-Chain
328-
- Base Mainnet
329-
- BSC Mainnet
330-
- Ethereum Mainnet
331-
- Optimism Mainnet
332-
- Polygon Mainnet
333-
334-
We are working on fine-tuning the model to enable more chains.
335-
336-
### How is the spam status of a collection determined?
337-
338-
We determine a collection’s spam score using a variety of features drawn from transfers data and metadata. We have several AI models that analyze these features in different ways. We then aggregate the results from the various models into a combined score, which is reported back.
339-
340-
### How can I report an issue with a collection that was incorrectly labeled as spam or not spam?
341-
342-
Reach out on [Discord](https://discord.gg/graphprotocol) in the [Token API](https://discord.com/channels/438038660412342282/1354235849532903625) channel.
343-
344308
## Advanced Topics
345309

346310
### I keep seeing a smart contract with addresses like `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` and `0x0000000000000000000000000000000000000000`. What is this?

0 commit comments

Comments
 (0)