Subscribe to this thread
Home - General / All posts - mfd9 doc table of contents not optimal for robots
rk
680 post(s)
#15-Jul-26 09:12

I was preparing Claude skill for "Manifold 9 SQL" and it complained about https://manifold.net/doc/mfd9/index.htm that:

the

index.htm

you gave me is blocked to robots, so a skill shouldn't rely on the table of contents.

I know from past experience (when Radian first appeared) that it is not trivial to get a whole list of topic links from the TOC. One must hunt the TOC tree for whlstt*.htm files.

Claude found https://manifold.net/doc/mfd9/sql.htm as a useful "hub" of links.

I think I'm not blocked, but perhaps something to consider.

Dimitri


7,628 post(s)
#15-Jul-26 20:59

The problem is that when you point Claude at the root of the Help system, it's looking at client-side JavaScript and Claude's bot doesn't execute JavaScript. Claude's background URL-retrieval robot is a lightweight scanner designed to fetch static pages quickly. It does not run a complex browser engine, meaning it completely ignores the javascript that organizes the table of contents and fetches pages as you browse through the documentation.

Instead of saying "My JavaScript engine didn't run and the page is blank," Claude's engine falls back on its default logic for empty index pages: it incorrectly concludes that the site must be hiding its content from automated scripts or filtering robots out.

I asked how that might be fixed by one of our engineers and he said he'd add a sitemap.xml to the documentation folder. There's now a file at https://manifold.net/doc/mfd9/sitemap.xml that gives the direct URL to every topic's own .htm file. I think you could give Claude that url and it would be enough for it to get to all the topics, no javascript involved.

Sloots

717 post(s)
#16-Jul-26 19:32

This is Claude's response:

I couldn't retrieve manifold.net's actual robots.txt content — my search didn't return a direct link I could fetch. But I can explain the general format and what would need to change.

What a robots.txt file looks like:

User-agent: *

Disallow: /doc/

Disallow: /admin/

User-agent: Googlebot

Allow: /

It always lives at the root of a domain, e.g. https://manifold.net/robots.txt. Each block starts with User-agent: (which bot the rule applies to), followed by Disallow: (blocked paths) or Allow: (exceptions to a disallow).

What would need to change:

For my web_fetch tool to access /doc/mfd9/, Manifold would need to add something like:

User-agent: *

Allow: /doc/mfd9/

or remove that path from disallowed entries entirely. That's only something the site owner can change — I have no control over it.


http://www.mppng.nl/manifold/pointlabeler

Dimitri


7,628 post(s)
#16-Jul-26 19:44

There's no robots.txt file anywhere in Manifold's web site or documentation web hierarchy. Can Claude read all of the topics if you point it at https://manifold.net/doc/mfd9/sitemap.xml ?

Sloots

717 post(s)
#22-Jul-26 07:37

I asked Claude if it could fetch https://manifold.net/doc/mfd9/sitemap.xml

This is Claude's response (after I told it there is no robots.txt file)

I looked into this further. I can fetch the manifold.net homepage fine, but any page under /doc/ — including the sitemap — gets blocked by my fetch tool with a robots-disallowed error, so it does appear there's a rule (likely something like Disallow: /doc/) covering that whole documentation section specifically, even if the root /robots.txt itself doesn't jump out when searched. This is a restriction built into my browsing tool, not something I can override — I'm not able to check the raw /robots.txt file directly to show you the exact rule.

And this is how ChatGPT reacts on the same prompt:

I can read the Manifold Release 9 documentation pages, but the sitemap URL itself currently returns a 502 Bad Gateway through my web access. The main documentation index is accessible, including its table of contents.


http://www.mppng.nl/manifold/pointlabeler

rk
680 post(s)
#22-Jul-26 10:45

Oh, I added the sitemap link to the skill, but I have not exercised the skill yet.

Me:

/manifold-sql9

i added link to sitemap to the skill. can you access it?

Claude Opus 4.8:

I can see the line you added (line 80: the sitemap at https://manifold.net/doc/mfd9/sitemap.xml). Let me try to fetch it.

The fetch tool won't take the URL directly from the skill file — it only accepts URLs that came from a prior search or fetch. Let me surface it via search first.

The search returned individual doc pages but not the sitemap URL itself, so the fetch tool still won't have it whitelisted. Sitemaps generally aren't in search indexes, so this is a bit of a chicken-and-egg problem. Let me try one more search angle.

The sitemap URL isn't showing up as a search result — search engines don't index sitemap.xml files the way they index normal pages, so the fetch tool never gets it whitelisted. Let me confirm whether bash/curl is an option.

Short answer: no, I can't reach it right now — and it's blocked two different ways, neither of which the skill can fix on its own.

The web_fetch tool only accepts URLs that first appeared in a search or fetch result. Sitemaps aren't indexed by search engines the way regular pages are, so sitemap.xml never shows up in results and never gets whitelisted — the fetch is rejected before it's even attempted. And curl from the sandbox fails too, because manifold.net isn't on the bash network egress allowlist (only Anthropic, GitHub, npm, PyPI, Ubuntu, and crates hosts are permitted). So the sitemap is unreachable by either route.

Worth separating from that: the individual doc pages work fine. Several manifold.net/doc/mfd9/*.htm pages came back in my searches just now (introduction, wms_servers, getting_started, etc.), and those are fetchable once a search surfaces them — which is exactly the search→fetch workflow the skill already describes. It's only the sitemap that's stuck.

A few ways forward, depending on what you wanted the sitemap for:

If the goal was to give me a browsable index of every doc page (since /doc/mfd9/index.htm is robots-blocked), the sitemap won't serve that purpose through these tools regardless. A better fit for the skill would be to keep expanding the "Doc entry points known to exist" table with confirmed URLs, since those are the ones I can actually reach.

If you specifically want me to be able to read the sitemap, either add manifold.net to your bash network egress settings (then curl works and I can parse the whole thing), or just paste/upload the sitemap contents and I'll extract the URL list for you.

I do not get why sitemap won't work regardless.

I do not know what bash network egress settings are.

Dimitri


7,628 post(s)
#22-Jul-26 19:32

I do not know what bash network egress settingsare.

I don't either, but you can ask Claude to walk you through that step by step. You could also download the contents of that .xml file into, say, a .txt file and then upload that as part of your chat. I don't know if your chat will accept that many characters if you paste it, but I think most AI's will let you upload a text file.

Manifold User Community Use Agreement Copyright (C) 2007-2021 Manifold Software Limited. All rights reserved.